推荐 序 一 


技术 革命 创造 着 无 数 的 奇迹 。 互 联网 、 物 联网 、 移 动 计算 、 大 数据 、 云 计算 等 技术 的 出 现 正 在 改变 着 人 类 生活 的 方方面面 。 


区 块 链 技术 以 其 去 中 心 、 完 整 、 真 实 、 公 开 、 安 全 等 的 特点 ， 已 经 成 为 新 一 轮 全 球技 术 创新 与 变革 的 核心 。 英 国 《经 济 学 人 》 杂 志 曾 预测 “区 块 链 将 重新 定义 世界 ”。 麦 肯 锡 将 区 块 链 技术 称 为 “ 继 蒸 
汽机 、 电 力 、 信 息 和 互联 网 科技 之 后 ， 目 前 最 有 潜力 触发 第 五 轮 颠 覆 性 革命 浪潮 的 核心 技术 ”。 


区 块 链 是 万 物 账本 ， 几 乎 可 以 记录 任何 有 价值 的 东西 ， 包 括 账 务 账目 、 投 票 、 版 权 及 产权 任何 可 以 用 代码 来 表示 的 东西 。 在 万 物 互联 的 时 代 ， 每 个 人 都 可 以 在 这 个 “账本 ”上 留 下 不 可 修改 的 痕迹 。 这 
些 痕迹 可 以 回溯 一 个 人 过 往 的 所 有 经 历 ， 这 对 今后 的 法 律 、 政 治 、 经 济 等 各 个 方面 所 产生 的 影响 将 是 巨大 的 。 


传统 互联 网 构建 的 是 信息 传递 网 络 ， 区 块 链 构建 的 则 是 价值 传递 网 络 。 价 值 传递 网 络 的 出 现 ， 可 以 使 万 物 互信 、 万 物 共享 成 为 可 能 ， 使 各 行 各 业 可 以 跨 界 互联 ， 催 生 新 业务 、 新 行业 和 新 模式 ， 创 造 新 
机 遇 。 作 为 未 来 互联 网 的 基础 协议 之 一 ， 区 块 链 将 支撑 新 型 信任 体系 的 构建 ， 由 此 引发 “信誉 革命 ” ， 其 最 终 影响 的 范围 和 深度 也 会 远 远 超出 大 多 数 人 的 想象 。 
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以 内 容 产 业 为 例 ， 多 年 来 ， 编 辑 出 版 行业 各 个 机 构 都 在 数字 出 版 领域 艰难 地 研究 与 探索 。 但 是 苦于 没有 合适 的 技术 ， 叶 致 在 当下 的 互联 网 生态 中 ， 版 权 侵权 现象 严重 ， 纠 纷 频 发 ， 加 之 举证 困难 、 维 权 
成 本 过 高 ， 严 重 侵害 了 作者 的 原创 积极 性 ， 这 已 经 成 为 内 容 产业 的 痛 点 。 如 今 ， 区 块 链 技术 的 出 现 使 数字 化 知识 内 容 的 确 权 、 确 真 和 确 价 成 为 可 能 。 区 块 链 可 以 完整 地 记录 一 个 作品 从 灵感 到 最 终 作 品 的 所 
有 变化 过 程 ， 可 以 保证 数字 内 容 的 价值 转移 过 程 的 可 信 、 可 审计 和 透明 ， 为 版 权 保护 提供 了 最 完美 的 解决 方案 。 区 块 链 技术 的 引入 将 极 大 提升 内 容 产 业 的 运行 效率 ， 从 确 权 、 用 权 、 维 权 三 个 环节 解决 产业 
链 匈 长 繁杂 的 问题 。 


正 是 在 这 种 产业 背景 下 ， 国 内 一 批 区 块 链 技术 先锋 积极 投身 到 基于 区 块 链 技术 的 出 版 平台 开发 中 。 其 中 ， 朱 志文 先生 带领 的 “ 亿 书 ”团队 就 是 这 批 技术 先锋 的 杰出 代表 ， 他 们 利用 区 块 链 技术 打造 
的 “ 亿 书 ”去 中 心 化 的 出 版 平台 实现 了 版 权 签 名 与 认证 、 协 同 创作 、 一 键 发 布 等 功能 ， 这 将 极 大 激发 作者 的 原创 动力 与 热情 。“ 亿 书 ”平台 的 出 现 ， 是 我 国内 容 产业 发 展 探索 中 的 一 个 重要 节点 ， 更 为 知 
识 的 价值 传播 做 出 了 重要 的 基础 性 探索 。 


《Nodejs 区 块 链 开 发 》 是 朱 志 文 先生 带领 的 “ 亿 书 ”团队 多 年 艰辛 实践 的 结晶 ， 相 信 这 本 书 能 够 为 广大 区 块 链 技术 人 员 和 爱好 者 提供 有 益 的 参考 和 借鉴 。 同 时 ， 也 希望 更 多 的 开发 者 加 入 区 块 链 的 大 潮 
中 ， 积 极 推动 区 块 链 技术 在 内 容 产 业 中 的 应 用 实践 ， 让 区 块 链 成 为 知识 服务 的 重要 工具 。 


我 们 坚信 ， 内 容 产业 的 革命 即将 到 来 。 此 时 此 刻 ， 我 们 已 经 站 在 了 变革 的 临界 点 。 


过 去 已 去 ， 未 来 已 来 。 
科学 技术 文献 出 版 社 副 社 长 ” 李 沛 


2017 年 4 月 5 日 


推荐 序 二 


微 博 上 曾 有 人 感慨 : “小 说 家 死 了 ， 他 的 小 说 还 会 有 人 读 ; 程序 员 死 了 ， 他 就 被 人 忘 了 。99% 的 软件 ， 其 生命 周期 不 超过 5 年 ， 这 意味 着 你 现在 写 的 代码 ，5 年 后 将 毫 无 用 处 。 如 何 做 一 些 能 留 得 下 来 的 
事情 ， 是 每 个 程序 员 应 该 认真 思考 的 问题 。” 这 条 微 博 一 经 发 出 ， 立 即 引得 众多 程序 员 感 慨 万 干 。 


但 这 里 有 一 个 真实 的 案例 显示 ， 代 码 的 命运 并 不 都 是 这 样 。2008 年 ， 中 本 聪 发 布 了 比特 币 白 皮 书 。2009 年 1 月 ， 他 开发 了 比特 币 的 第 一 个 版 本 ， 也 就 是 人 们 所 熟知 的 satoshi 客 户 端 。8 年 来 ， 无 数 开发 
者 为 比特 币 提交 了 代码 ， 中 本 聪 的 代码 被 保留 下 来 的 微乎其微 ， 目 前 仅 占 代码 总 量 的 2%， 但 他 的 思想 被 原原本本 地 继承 了 下 来 ， 那 就 是 “去 中 心 化 ”理念 : 区 块 链 就 如 同一 台 信 用 的 机 器 ， 让 政府 、 公 司 、 
机 构 与 个 体 作为 平等 的 节点 呈现 在 分 布 式 网 络 上 ， 各 自 管理 自己 的 身份 与 信用 ， 共 享 一 部 不 可 修改 的 交易 总 账 。 最 近 ， 另 一 个 区 块 链 项 目 “ 以 太 坊 ” 不 顾 社区 的 反对 ， 强 行 发 起 一 次 硬 分 又 ， 回 滚 了 区 块 链 
数据 ， 引 来 不 小 争议 。 


区 块 链 与 普通 软件 项 目的 不 同 之 处 在 于 ， 它 是 去 中 心 化 的 。 这 就 意味 着 它 可 能 遵循 不 同 的 开发 组 织 理 念 ， 比 如 官方 对 于 区 块 链 项 目 可 能 并 不 那么 重要 ， 甚 至 连 官方 这 个 词 都 是 值得 商检 的 ， 因 为 软件 是 
开源 的 ， 任 何人 都 可 以 开发 它 的 新 版 本 ， 或 者 分 叉 出 一 条 新 链 。 即 使 存在 官方 ， 也 并 不 意味 着 区 块 链 就 是 其 产品 ， 官 方 并 不 拥有 区 块 链 数据 修改 的 主导 权 。 区 块 链 更 像 是 把 数据 (信用 ) 写 在 无 限 纸 带 上 的 
单 向 图 灵机 ， 能 够 根据 指令 读 写 当前 纸 带 格子 上 的 数据 ， 每 执行 一 条 指令 就 往 后 移动 一 格 ， 但 不 能 修改 过 去 所 写 入 的 数据 。 


与 所 有 开源 社区 一 样 ， 比 特 币 等 区 块 链 项 目的 开发 方式 具有 这 样 一 些 特征 : 


1) 人 们 按照 自己 的 兴趣 和 意愿 选择 加 入 ， 开 发 者 并 非 项 目 发 起 人 或 官方 的 雇 


bl 


2) 任何 人 都 可 以 无 偿 获取 开源 项 目的 源码 及 相应 的 编程 工具 ， 并 为 项 目 贡献 自己 的 代码 。 


3) 软件 开发 和 发 布 的 主体 并 非 公司 ， 而 是 一 些 基金 组 织 或 个 人 ， 他 们 不 以 盈利 为 目的 。 


4) 参与 人 员 分 布 于 全 球 各 地 ， 彼 此 间 通 过 互联 网 进行 协作 。 


然而 ， 就 是 这 种 看 似 松散 、 不 稳定 的 工作 组 织 方式 ， 却 爆发 了 惊人 的 生产 力 。 对 于 比特 币 这 样 的 区 块 链 项 目 ， 对 规则 的 任何 重大 改变 都 需要 获得 社区 的 广泛 共识 ， 对 软件 的 任何 更 新 都 必须 由 大 多 
数 “矿工 ”安装 使 用 后 才能 让 修改 生效 。 正 如 本 书 的 作者 所 言 : “区 块 链 产品 都 是 去 中 心 化 的 ， 去 中 心 化 的 基础 就 是 P2P 节 点 众多 。 那 么 如 何 吸引 用 户 加 入 网 络 成 为 节点 ， 有 哪些 激励 机 制 ? 同时 ， 开 发 的 
重点 是 让 多 个 节点 维护 一 个 数据 库 ， 那 么 如 何 决定 哪个 节点 写 入 ? 何 时 写 入 ? 一 旦 写 入 ， 又 怎么 保证 不 被 其 他 的 节点 更 改 (不 可 逆 ) ? 解决 这 些 问题 的 答案 就 是 共识 机 制 。” 


起 初 ， 本 书 作者 以 imfly 这 个 ID 在 巴 比 特 社区 发 贴 ， 分 享 “用 Nodejs 开 发 加 密 货币 ”的 经 验 与 心得 ， 正 如 许多 开源 项 目的 艰难 起 步 一 样 ， 一 开始 并 没有 得 到 多 少 支 持 。 但 令 人 欣慰 的 是 ，imfly 坚 持 
了 下 来 ， 并 有 了 更 多 志同道合 的 朋友 加 入 ， 从 而 有 了 巴 比 特 社区 的 开发 者 群体 ， 有 了 这 本 书 。 在 此 过 程 中 ，imfly 发 起 了 “ 亿 书 ”这 个 开源 项 目 ， 骨 在 打造 人 人 可 用 的 去 中 心 化 软件 ， 以 区 块 链 为 底层 驱动 ， 
促进 人 类 知识 分 享 。 本 书 分 享 的 就 是 亿 书 的 源码 ， 无 论 研究 Crypti、Lisk 还 是 Ebookcoin， 或 者 学 习 Node.js 前 后 端 开发 技术 ， 本 书 都 将 提高 你 的 学 习 与 开发 效率 。 


区 块 链 项 目 一 般 是 基于 开源 的 工作 方式 ， 所 以 只 要 接 入 互联 网 ， 任 何人 都 可 以 随时 随地 获得 开源 的 代码 、 文 档 并 在 之 上 做 出 贡献 ， 也 就 是 说 ， 全 社会 的 力量 都 可 以 贡献 于 同一 份 代码 和 文档 系统 。 而 传 
统 项 目 往往 受制 于 安全 管理 ， 这 种 情况 不 只 是 出 现在 不 同 的 公司 之 间 ， 即 使 在 一 个 公司 的 内 部 ， 一 个 产品 的 代码 往往 也 会 被 分 割 为 几 块 ， 分 别 由 不 同 的 人 访问 和 维护 。 同 时 由 于 代码 涉及 商业 利益 ， 即 使 发 
现 错误 ， 开 发 者 也 不 一 定 有 权限 去 做 相应 的 修改 ， 这 些 都 会 使 得 代码 的 质量 不 断 下 滑 。 如 果 你 有 一 颗 梦 想 的 种 子 ， 与 其 让 它 在 阴暗 的 角落 独自 生长 ， 不 如 像 亿 书 这 样 公 布 于 社区 ， 让 众人 参与 其 中 ， 让 它 像 
蒲公英 一 样 四 处 传播 。 本 书 将 帮助 你 了 解 亿 书 的 架构 设计 ， 帮 助 你 快速 融入 亿 书 开源 社区 这 个 大 家 庭 里 。 


长 忽 


正如 互联 网 的 前 身 ARPANET 一 样 ， 


自称 “中 本 聪 ” 


育 


想 和 原理 。 


转眼 间 8 征 


值得 庆幸 的 是 ， 我 们 离 这 一 次 的 “ 
随后 逐步 进入 这 样 一 个 新 兴 行 } 
6 交易 网 络 的 安全 运行 。 


比特 


然而 ， 一 个 不 那么 乐观 的 
经 济 金融 制度 比较 僵化 ， 于 是 导 
时 代 到 来 之 前 ， 在 这 两 个 领域 都 有 研究 的 


其 次 ,我 国 


用 1 


FF 过去， 比特 
为 下 一 代价 值 互联 网 乃至 人 工 智能 、 


6 从 极 客 圈子 中 的 “小 玩意 儿 " 
网 络 智能 | 


区 块 链 革命 


区 块 链 的 前 身 比特 f 
(意译 名 ) 的 开发 者 出 现 。 这 位 神秘 的 开发 者 在 2008 生 
神秘 的 开发 者 又 悄悄 地 隐 退 ， 他 “悄悄 的 走 了 ， 正 如 他 悄悄 的 来 ”， 但 与 《再 别 康桥 》 中 不 同 的 是 ， 他 留 下 了 比特 币 及 其 基础 架构 


和 最初 也 是 小 众 圈子 号 


巴 比 特 创始 人 兼 CEO ， 著 名 科幻 作家 


2017 年 1 月 14 日 
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有 的 产物 。 从 20 世 纪 90 稀 
F 低 调 地 将 一 篇 简约 而 不 简单 的 论文 发 表 到 


克 ” 小 组 的 极 客 们 就 为 了 网 络 交易 的 实现 而 不 断 创新 、 实 验 及 经 受 失败 ， 直 到 一 
并 发 布 了 基于 论文 的 核心 代码 。 此 后 ， 在 人 们 怀疑 、 争 议和 尝试 的 过 程 中 ， 这 位 
区 块 链 技术 ， 更 重要 的 是 ， 他 留 下 了 被 称 为 “新 一 代价 值 传递 网 络 ” 的 思 


F 代 开始 ，“ 密 码 朋 
网 络 


由 


变 成 了 


9 基础 设施 级 协议 。 


6 值 超过 130 亿 美元 的 数字 货币 ， 而 源 ] 


， 并 没有 像 上 一 次 互联 网 革命 那么 远 。2011 征 


区 块 链 技术 很 有 可 能 会 成 


比特 币 的 整个 区 块 链 行业 的 市 值 超 过 了 300 亿 美元 。 有 不 少 研究 者 认为 ， 


全 、 迷 茫 开 始 ， 逐 渐 了 解 比特 币 的 原理 ， 


不 少 敢于 吃 旺 蟹 的 人 从 不 


左右 ， 比 特 币 这 一 新 生 事物 传 入 我 


国 a 


| 


目 。 到 了 2016 年 ， 我 


F, 


诞生 了 十 多 家 比特 币 交易 所 ， 我 


Ea 


对 于 任何 一 个 


实 是 ， 中 国 


在 


区 块 链 从 业者 来 说 ,不论 开发 、 合 作 还 是 推 / 


区 块 链 行业 开发 领域 鲜 有 建树 。 造 成 这 个 对 


交易 所 的 总 交易 量 占 了 全 


球 交 易 量 的 70% 以 上 ; 我 国 “ 矿 工 ” 为 整个 比特 币 网 络 提供 了 超过 60% 的 算 力 ， 保 障 着 整个 


国 


， 中 


国 


和 场 都 是 需要 着 重 考虑 的 


中 系 。 


实 的 


原 


内 的 开发 技术 整体 还 相对 落后 ， 在 区 块 链 技术 领域 缺乏 积累 ， 创 新 能 力 更 加 不 足 ; 


要 有 三 个 : 首先 ， 国 


国 


致 我 国 在 这 方 
人 少 之 又 少 。 


面 的 研究 创新 比较 少 ， 在 货 


| 


以 上 所 述 情况 导致 我 国 


里 
里 


然 在 区 块 链 行业 有 着 很 


值 的 技术 开发 和 应 


上 长 期 


。 更 令 人 担忧 的 是 ， 不 少 


空白 


古人 云 ， 授 人 以 鱼 不 如 授 人 以 渔 。 在 这 样 的 背景 


的 地 位 ， 但 是 核心 开发 的 贡献 率 非常 低 ， 在 整个 行业 的 话语 权 并 不 高 。 在 
5” 的 概念 进行 传销 及 非法 融资 等 活动 ， 给 国 


“数字 货 T 


非法 分 子 开始 利 


非常 令 人 欣慰 的 。 沟 通 之 精 要 ， 在 于 深入 浅 出 。 
次 修订 成 书 ， 他 更 是 对 整个 技术 开发 进行 了 系统 地 编 提 


6 制度 和 经 济 发 


， 能 够 有 朱 志 文 这 样 的 技术 专家 站 出 来 ， 采 


想 做 到 
0 


通俗 易 昼 


屈指 可 数 ; 最 后 ， 金 融和 网 络 技术 原本 是 非常 跨 界 的 两 个 领域 ， 在 互联 网 金 


展 方面 有 专长 的 人 才 就 更 加 


区 块 链 市 场 上 ， 数 字 货币 兑换 交易 占 了 非常 大 的 比例 ， 但 在 最 具 价 
此 抹 上 了 不 光彩 的 颜色 。 


国 


内 


内 的 
的 区 块 链 行 } 


区 块 链 开发 ”的 经 验 与 心得 ， 这 是 


6 的 技术 开发 原理 ， 分 享 自己 “Nodejs 


手把手 的 教学 方式 讲解 数字 货 


痢 ， 背 后 所 要 花费 的 时 间 与 精力 是 非常 之 多 的 。 朱 志文 陆 陆 续 续 发 表 了 不 少 文章 ， 我 们 从 中 可 以 看 出 他 是 经 过 了 认真 、 充 分 的 准备 的 。 这 一 


我 国 的 
技术 的 理念 ， 推 广 数 


正如 本 书 所 述 ， 不 论 采 
展 的 基石 。 


未 来 人 类 社会 发 


字 全 


区 块 链 行业 需要 更 多 像 朱 志 文 这 样 的 技术 大 咖 ， 也 同样 需 
区 块 链 行业 的 投入 ， 推 动 我 国 


6 的 价值 ， 带 领 资本 加 大 对 


什么 样 的 技术 来 实现 ， 


的 


区 块 链 是 一 个 新 生 奸 


希望 大 家 通过 本 书 不 仅 能 知 其 


有 物 ， 在 拿 起 放大 镜 进 行 审视 和 


所 以 然 。 


然 ， 还 能 知 其 


订 。 相 信 这 样 的 技术 分 享 能 够 帮助 


更 多 的 资本 投入 ， 以 帮 
区 块 链 产业 健康 导 


国 


6 的 原理 ， 助 力 他 们 进行 进一步 开拓 创新 。 


内 的 区 块 链 开发 者 夯实 基础 ， 逐 步 掌 握 数 字 货 


区 块 链 技术 背后 的 基本 原则 是 不 会 变 的 。 诚 信 正 直 、 分 散 运作 、 价 值 激励 、 权 利 保护 、 隐 私 保 


惯性 思维 去 批判 之 前 ， 让 我 们 一 起 变 成 一 块 虚 心 的 海绵 ， 先 来 学 习 一 下 


6 愿意 以 一 个 布道 者 的 身份 ， 传 播 区 块 链 


6 行业 的 领军 企业 之 一 ， 火 i 
自己 的 贡献 。 


展 。 作 为 中 
同时 也 为 全 球 的 


国 数字 货 生 


区 块 链 行业 做 出 


整个 产业 的 健康 发 
好 地 发 


帮 ， 


区 块 链 运行 的 基础 ， 也 是 


阐 、 开 放 包 容 ， 这 些 理念 不 仅 是 


区 块 链 的 原理 ， 感 受 一 下 它 的 魅力 ! 


学 


徐 宝 龙 
火 币 区 块 负责 人 


2017 年 1 月 28 日 


本 书 
但 讨论 的 


原名 《Nodejs 


“每 一 件 与 众 不 同 的 


内 容 实际 上 就 是 


发 加 密 货 条 


区 块 链 技术 。 就 在 本 书 整理 出 版 的 时 候 ， 


家 发 布 了 《中 国 


国 


5》， 大 部 分 已 经 通过 网 络 免费 分 享 (网 络 上 仍 有 原文 ) ， 正 式 
区 块 链 技术 和 应 


部 分 章节 也 做 了 调整 。 写 作 本 书 的 时 候 ，“ 区 块 链 ” 这 个 称呼 并 不 流行 ， 
区 块 链 ”这 个 称谓 ， 因 此 改 为 现在 的 名 字 。 


版 的 时 候 改 成 了 现在 的 名 字 ， 
发 展 白皮书 》， 整 个 社区 也 接纳 了 “ 


绝世 好 东西 ， 其 实 都 是 以 无 比 寂寞 的 勤奋 为 前 提 的 ， 


么 是 


句 话 ， 总 能 被 感动 。 后 来 ， 与 那 位 朋友 陡 


能 被 感动 。 


= 
写 写 书 ， 一 各 


匠 精 神 人 人 推崇 ， 
下来， 仅仅 版 税收 入 也 


但 不 是 人 人 都 能 做 到 ， 环 


网 挣 更 多 钱 。 他 说 试 过 


听 着 他 的 话 ， 我 始终 沉默 ， 当 初 我 也 想不到 出 路 ， 时 代 变 迁 ， 谁 都 无 法 阻拦 。 但 是 ， 这 两 生 
正常 不 过 的 道理 。 这 位 朋友 的 问题 就 是 亿 书 诞生 的 初衷 ， 没 有 任何 离奇 的 故事 ， 都 是 满 满 的 生活 小 节 ， 这 多 少 也 有 点 工 


了 ， 没 那么 简单 ， 几 大 文学 


天 ， 我 说 你 真有 才 ， 能 把 一 句 话说 到 人 的 内 


境 往往 起 到 了 很 大 的 作 
FE 常 可 观 。 但 是 ， 最 近 几 稀 


血 ， 要 么 是 汗 ， 
心 深 处 ， 我 若 不 是 | 


妙 青 春 好 时 光 ”。 这 是 一 位 文笔 非常 好 的 朋友 大 学 毕业 后 给 我 的 留言 。 每 每 读 到 这 
出 哭 一 场 。 他 一 听 ， 十 分 感慨 ， 告 诉 我 他 也 是 摘抄 来 的 ， 还 说 只 有 经 历 过 ， 才 


么 是 大 把 大 把 的 
因为 是 男人 ， 一 定 美美 


首先 想到 的 自然 是 身边 人 ， 这 是 和 
当 3 
索 之 后 ，2015 年 ， 我 把 关于 


打造 电子 书 版 权 保 护 项 


的 真实 源码 作为 分 享 的 3 


下 来 ， 待 亿 书 正式 发 布 


亿 书 ， 以 价值 传播 为 目标 ， 定 位 在 协同 创作 和 版 权 保护 ， 从 底 


， 就 可 以 


的 想法 在 网 上 和 
要 内 容 ， 边 分 享 边 开发 ， 边 打造 团 
亿 书 (软件 ) 来 继续 分 享 亿 书 (源码 ) 了 。 这 就 像 C/C+ + 这 样 的 编程 语言 


队 ， 这 中 


。 还 是 我 的 那 位 朋友 ， 刚 毕业 的 时 候 ， 他 去 了 某 机 关 报 社 ， 最 初 当 记者 ， 待 遇 优 厚 ， 
好 像 不 太 好 了 ， 有 一 次 聊天 明显 感觉 到 他 的 消极 ， 问 他 怎么 了 ， 他 说 互联 网 抢 了 他 们 的 饭碗 。 我 疝 ， 那 你 就 抢 回 来 吧 ， 化 敌 为 友 ， 借 助 互 联 
站 ， 那 么 多 作者 ， 真 正 挣 到 钱 的 没有 几 个 。 偶 尔 火 起 来 了 ， 大 部 分 都 被 平台 分 去 了 ， 有 的 甚至 连 版 权 都 得 不 到 。 加 之 盗版 猩 狐 ， 基 本 入 不 敷 出 。 


自在 遂 遥 。 这 中 间 ， 他 还 经 常 


后 来 做 编辑 ， 


E 动 往 版 权 保护 和 写作 分 享 发 力 的 时 候 ， 资 源 就 源源 不 断 地 聚集 到 了 我 的 面前 。 亿 书 ， 这 个 去 中 心 化 的 版 权 保护 和 知识 直销 系统 ( 
盘 托 出 ， 吸 引 了 很 多 小 伙伴 的 关注 ， 同 时 


的 , 开发 者 


F 我 有 了 方向 ， 找 到 了 可 以 彻底 解决 的 办 法 ， 这 也 是 我 坚持 分 享 这 本 书 的 内 在 动力 。 软 件 是 给 人 
匠 精 神 的 情结 吧 。 


自 出 版 平台 ) 的 操作 过 程 大 致 是 这 样 的 : 在 经 过 一 段 时 间 的 技术 探 
行动 实践 电子 书写 作 和 分 享 的 全 过 程 ， 并 把 亿 书 这 个 项 


也 证 明了 想法 的 可 行 性 。 接 着 , 我 


层 区 块 链 版 权 协 议 到 顶 


间 提 交 了 多 个 开源 代码 (本 书 多 个 实例 便 是 其 中 一 部 分 ) 。 读 者 越 来 越 多 ， 团 队 日 益 壮 大 ， 仍 有 很 多 小 伙伴 在 了 解 、 考 察 和 熟悉 中 。 接 
可 以 用 来 开发 自己 ， 开 发 者 也 是 使 用 者 ， 自 身 不 断 循环 完善 。 
屋 客 户 端 应 用 ， 完 全 自主 开发 ， 是 国内 少 有 的 不 依赖 于 比特 币 、 以 太 坊 等 国外 第 三 方 平 台 的 产品 。 新 版 产品 提供 了 


强大 的 扩展 开发 能 力 ， 基 于 亿 书 可 轻松 开发 很 多 类 型 的 去 中 心 化 应 用 ， 比 如 数字 资产 管理 、 财 务 结算 与 审计 、 交 易 存 证 与 监控 、 电 子 商 务 、 视 频 直 播 等 。 这 仍然 是 从 基础 需求 起 步 ， 步 步 搭建 积木 的 思路 和 
过 程 ， 与 我 通过 写作 本 书 体验 产品 需求 ， 然 后 发 展 亿 书 的 思路 一 样 。 这 是 工程 学 的 基础 ， 再 厉害 的 天 才 也 无 法 逾越 。 


亿 书 注定 要 成 为 价值 传播 领导 者 ， 开 启 数字 出 版 新 时 代 。 


这 是 本 什么 样 的 书 ? 


亿 书 是 完全 开放 开源 的 项 目 ， 是 一 个 完整 的 类 比特 币 的 区 块 链 产品 。 本 书 基于 该 项 目 ， 完 全 以 实用 为 目的 ， 将 开发 实践 贯穿 始终 ， 内 容 涉 及 开发 区 块 链 产品 前 端 、 后 台 和 桌面 应 用 的 全 过 程 。 本 书 用 开 
发 的 思维 进行 反复 迭代 ， 由 浅 入 深 ,， 详 细 介 绍 了 区 块 链 技术 相关 理论 知识 、Nodejs 前 后 台 开发 基础 知识 、 加 密 签名 技术 、P2P 网 络 实现 、 共 识 算法 等 ， 能 帮助 初学 者 快速 学 习 入 门 区 块 链 技术 ， 深 入 掌握 
Nodejs 编 程 开发 技术 ， 帮 助 区 块 链 技术 从 业者 、Web 开 发 者 更 深刻 地 理解 相关 概念 和 技术 实现 。 


“ 想 找到 关于 如 何 开发 一 款 真正 的 区 块 链 产 品 〈 不 只 是 调用 某 款 加密 货 币 API) 的 图 书 吗 ? 这 可 能 是 目前 世界 上 第 一 本 ， 也 可 能 是 唯一 的 一 本 。 
“ 想 找到 关于 Node.js 大 型 实践 项 目的 图 书 吗 ? 这 可 能 是 世界 上 少 有 的 一 本 ， 也 可 能 找 不 到 第 二 本 。 

“ 想 找 到 亿 书 、Lisk 等 基于 Crypti 的 分 支 项 目的 详细 开发 文档 吗 ? 这 一 定 是 世界 上 唯一 的 一 本 。 

“ 想 深刻 了 解 区 块 链 的 技术 实现 吗 ?” 看 看 本 书 ， 对 于 区 块 链 、 共 识 机 制 等 各 种 概念 的 理解 将 会 更 加 透彻 。 

“ 想 从 事 区 块 链 (无论 是 比特 币 还 是 其 他 各 类 竞争 币 ) 的 开发 吗 ? Node.js 一 定 是 无 法 回避 的 ， 这 本 书 也 必然 无 法 错过 。 


“ 想 了 解 比特 币 的 原理 吗 ? 这 本 书 不 仅 告 诉 你 其 原理 是 什么 ， 还 会 从 技术 的 角度 告诉 你 为 什么 ， 无 论 你 是 做 技术 还 是 做 管理 ， 本 书 都 值得 参考 。 


本 书面 向 的 读者 
* 开发 人 员 。 本 书 涉及 前 端 、 后 台 的 方方面面 ， 无 论 是 前 端 开 发 人 员 ， 还 是 后 台 开 发 者 都 可 以 学 习 参 考 。 
* 架构 师 。 区 块 链 本 身 是 分 布 式 、 云 计算 的 典范 ， 本 书 详细 描述 了 一 款 区 块 链 产品 的 架构 设计 ， 他 们 可 以 通过 本 书 学 习 掌握 区 块 链 是 如 何 基于 P2P 网 络 构建 复杂 的 自 适应 系统 的 。 


“ 高 校 学 生 、 教 师 、 科 研 人 员 等 。 本 书 内 容 在 网 络 上 分 享 的 过 程 中 ， 已 经 有 大 学 老师 作为 教 参 用 在 实际 教学 之 中 ， 本 书 从 概念 到 代码 实现 ， 理 论 与 实践 结合 紧密 ， 深 入 浅 出， 适合 系统 研究 学 习 区 块 链 
技术 。 


“学习 Node.js 的 读者 。 本 书 介 绍 了 Node.js 入 门 知 识 ， 包 含 了 Node.js 的 技术 原理 和 使 用 技巧 ， 是 一 个 完整 的 Node.js 使 用 案例 ， 有 一 定 JavaScript 基 础 的 初中 级 读者 ， 通 过 本 书 可 以 更 深入 的 学 习 提 高 使 用 


Node.js 编 码 技能 。 


“ 投资 人 ， 以 及 对 比特 币 等 区 块 链 产品 感 兴趣 的 普通 用 户 。 本 书 力求 语言 朴实 ， 书 写 过 程 中 尽量 避免 上 涩 的 技术 术语 ， 在 具体 的 编码 之 前 ， 都 要 详细 介绍 相关 概念 ， 因 此 投资 人 和 普通 读者 也 可 作为 科 
普 读物 ， 从 技术 层面 对 加 密 货 币 等 区 块 链 相 关 产 品 有 更 进一步 的 认识 。 


本 书 内 容 


本 书 力图 用 最 少 的 篇 幅 表述 更 丰富 的 内 容 ， 共 分 为 五 个 部 分 ， 具 体 结构 如 下 。 


第 一 部 分 : 了 解 区 块 链 ， 共 4 章 。 详 细 讲 述 了 区 块 链 产品 
理论 到 实践 的 过 渡 。 


加 密 货币 的 相关 概念 ， 用 独特 的 技术 视角 ， 把 加 密 货币 的 基本 技术 要 素 串联 起 来 ， 同 时 在 文中 自然 引导 读者 跳 转 阅读 下 面 各 个 部 分 ， 实 现 


第 二 部 分 : Nodejs 入 门 指南 ， 共 4 章 。 详 细 介绍 了 Nodejs 入 门 知识 ， 并 通过 一 个 具体 项 目 完成 对 Nodejjs 在 区 块 链 技术 领域 的 调查 和 描述 ， 整 个 部 分 也 是 项 目 架构 设计 必 备 的 调研 和 技术 选 型 阶段 ， 是 
本 书 第 一 个 完整 的 实践 范例 。 


第 三 部 分 : 源码 解读 ， 共 9 章 。 从 架构 设计 的 角度 ， 层 层 剖 析 区 块 链 的 设计 原理 ， 深 刻 解读 相关 概念 和 技术 。 从 项 目 设计 的 角度 谋 篇 ， 第 9 章 详细 介绍 了 亿 书 白皮书 的 核心 内 容 ， 明 确 了 项 目的 需求 ， 教 
读者 如 何 着 手 研究 区 块 链 产 品 ; 第 10 章 从 项 目 入 口 程序 出 发 ， 介 绍 了 亿 书 项 目的 整体 结构 ; 第 11 ~ 17 章 分 别 介绍 了 P2P 网 络 、 加 密 解 密 、 签 名 和 多 重 签名 、 区 块 链 、 共 识 机 制 等 区 块 链 核心 内 容 ， 并 给 出 了 
代码 实现 。 


第 四 部 分 : 开发 实践 ， 共 9 章 。 主 要 是 对 第 二 和 第 三 部 分 的 有 益 补充 ， 把 在 这 两 个 部 分 出 现 的 技术 难点 抽取 出 来 ， 集 中 介绍 。 仍 然 以 亿 书 项 目 中 涉及 的 实际 项 目 为 主 ， 包 含 多 个 完整 独立 的 小 项 目 。 第 
18 ~ 19 章 主要 介绍 了 函数 式 编程 等 编程 方法 论 ; 第 20 章 ， 介 绍 了 命令 行 工具 的 开发 ( 含 开源 实例 ) ; 第 21 章 总 结 了 aysnc 的 用 法 ， 解 决 了 Nodejs 回 调 流程 控制 问题 ; 第 22 ~ 23 章 介绍 了 亿 书 官方 网 站 的 开 
发 ， 对 市 面 上 的 静态 网 站 进行 了 总 结 ， 通 过 两 个 实例 详细 介绍 了 客户 端的 开发 设计 ; 第 24 章 详细 介绍 了 密码 学 技术 ; 第 25 章 介绍 了 时 间 戳 、 数 据 计 算 等 更 加 细致 的 优化 内 容 ; 第 26 章 介绍 了 测试 技术 。 


第 五 部 分 : 附录 。 汇 总 了 区 块 链 的 相关 概念 、 常 见 词汇 的 中 英文 对 照 等 内 容 。 


本 书 的 相关 资源 


本 书 分 享 的 开源 项 目 一 一 亿 书 ， 仍 在 持续 开发 中 ， 因 此 ， 当 您 在 阅读 本 书 源码 的 时 候 ， 核 心 代码 库 已 经 做 了 比较 大 的 修改 。 所 以 ， 我 将 本 书 分 享 的 源码 锁定 在 了 一 个 固定 的 版 本 里 。 有 关 亿 书 的 相关 资 
源 如 下 : 


“ 亿 书 官网 : http://ebookchain.org 
“ 亿 书 源码 : https://github.com/Ebookcoin/ebookcoin/tree/v0.1.3 
“ 亿 书 和 白皮书 : http://ebookchain.org/ebookchain.pdf 


: 亿 书 官方 QQ 群 : 185046161 


因 水 平 所 限 ， 书 中 难免 会 有 不 足 之 处 ， 为 了 方便 大 家 交流 ， 也 为 了 弥补 可 能 出 现 的 不 足 ， 我 在 区 块 链 俱乐部 论坛 上 与 本 书 配套 设置 了 一 个 勘误 版 块 ， 也 会 定期 回答 读者 的 问题 ， 欢 迎 大 家 访问 ， 地 址 如 


http://chainclub.org/ 


实际 上 ， 亿 书 和 本 书 都 是 开源 的 产物 。 非 常 欢迎 有 志 于 区 块 链 研 发 的 小 伙伴 参与 进来 ， 共 同 进步 。 


致谢 


我 是 个 极度 不 愿意 重复 的 人 ， 所 以 才 会 始终 保持 足够 的 热情 来 编写 软件 为 自己 服务 。 而 写 文章 恰恰 需要 反复 推 鼓 和 和 修改， 甚至 推倒 重 来 。 自 从 2016 年 年 初 决定 要 撰写 和 分 享 本 书 中 的 系列 文章 ， 并 从 中 
汲取 区 块 链 的 技术 营养 ， 我 就 做 好 了 各 种 思想 准备 。 为 了 防止 退缩 ， 我 还 在 网 络 上 公开 许 下 承诺 。 但 让 我 万 万 没有 想到 的 是 ， 战 胜 自己 是 如 此 艰巨 。 这 段 时 间 ， 我 几 度 放弃 ， 又 重新 开始 。 


很 庆幸 的 是 ， 在 这 个 过 程 中 ， 有 一 帮 小 伙伴 们 始终 陪伴 、 支 持 和 鼓励 着 我 。 


感谢 科学 技术 文献 出 版 社 李 沛 副 社 长 ， 他 对 知识 传播 领域 的 独到 见解 以 及 他 推崇 的 “知识 服务 商 ” 理 念 ， 让 我 很 受 启发 。 他 受 邀 为 本 书 作 序 ， 并 给 了 我 很 多 极为 宝贵 的 意见 和 建议 。 “知识 服务 商 ” 将 


会 成 为 亿 书 未 来 发 展 的 重要 理念 。 


感谢 出 版 社 的 编辑 杨 绣 国 


> 


亿 书 的 新 版 本 ， 从 每 一 个 细节 都 会 体现 这 一 思想 ， 让 每 一 个 使 用 亿 书 的 人 从 中 受益 ， 令 知识 的 创造 充满 动力 。 


老师 ， 给 了 我 极 大 的 宽容 和 鼓励 ， 她 极为 认真 地 帮 我 梳理 和 策划 书 的 内 容 ， 协 调 各 类 资源 。 


感谢 火 币 网 徐 宝 龙 ， 我 们 在 亿 书 组 织 的 区 块 链 茶座 上 相识 ， 一 见 如 故 ， 


上 给 我 发 来 了 他 为 本 书 撰写 的 


序言 ， 让 我 感动 不 已 。 


建 了 区 块 链 知识 库 。 


感谢 CSDN 技 术 社区 的 编辑 们 ， 这 是 一 群 充 ; 
区 


成 了 好 朋友 。 他 专注 区 块 链 行业 ， 给 我 、 给 亿 书 提供 了 很 多 宝贵 的 意见 和 帮助 。 他 不 仅 聪 明 ， 还 非常 勤奋 ， 居 然 在 大 年 初 一 的 晚 


激情 的 活跃 分 子 ， 在 @ 猫 白 @ 红 月 两 位 编辑 的 带领 下 ， 很 快 构建 起 多 个 开发 技术 知识 库 ， 在 社区 引起 了 强烈 反响 。 她 们 支持 本 书 ， 还 邀请 我 与 她 们 一 起 构 


感 澳 巴 比 特 论坛 的 几 个 小 伙伴 。 这 些 文章 最 先 发 布 到 巴 比 特 论坛 ， 巴 比特 的 @ 长 鲜 、@miner、@ 等 一 轮 残月 、@ 荫 大 大 等 ， 几 平 将 这 些 文章 篇 篇 都 设 为 精华 帖 ， 跟 踪 进 展 ， 给 予 极 大 的 关注 和 支持 。 


感谢 cnodejs.org 社 区 。 这 些 文章 后 来 陆续 在 cnodejs.org 上 同步 发 布 。 
大 的 支持 ， 还 主动 帮 有 我 推荐 和 宣传 ， 让 我 深 受 鼓舞 。 


因为 共同 的 爱好 ， 我 与 社区 很 多 Nodejs 技 术 大 咖 (@i5ting@Ic@Graper 等 ) 成 了 好 友 。 他 们 对 这 些 文章 给 予 了 充分 的 肯定 和 极 


感谢 亿 书社 区 的 小 伙伴 们 ， 比 如 @Tailor@ 火 易 @ 珍 惜 @ 一 @Mojie@cyio@zbinlin 等 ， 他 们 不 仅 支 持 我 ， 有 的 还 给 我 提供 了 内 容 。 当 然 ， 还 有 很 多 其 他 小 伙伴 ， 这 里 就 不 一 一 列举 了 。 


最 后 ， 感 谢 我 的 爱人 和 我 可 爱 的 儿子 ， 谢 谢 你 们 的 陪伴 。 


第 一 部 分 了解 区 块 链 


这 部 分 的 内 容 主 要 是 针对 没有 接触 过 区 块 链 技术 的 初学 者 。 当 然 ， 对 于 不 了 解 技 术 ， 在 币 圈 混 迹 多 年 的 小 伙伴 ， 也 是 有 用 的 ， 可 以 帮助 你 从 技术 实现 的 角度 ， 更 好 地 理解 区 块 链 的 相关 概念 。 


这 部 分 章节 ， 我 把 它 称 作 技术 类 软文 ， 理 论 知 识 更 多 一 些 。 我 们 知道 ， 对 于 普通 老百姓 而 言 ， 人 类 语言 的 


量 往往 非常 苍白 ， 特 别 是 在 描述 复杂 的 区 块 链 产品 的 时 候 ， 远 不 如 计算 机 语言 简洁 、 明 了 和 


力 
严谨 。 所 以 ， 阅 读 这 部 分 章节 时 ， 要 保持 良好 的 心态 ， 寻 求 文章 里 有 价值 的 东西 ， 避 免 把 自己 的 情绪 与 好 恶 挫 杂 其 中 (当然 也 不 要 受 作者 的 情绪 与 好 恶 左 右 ) ， 这 样 才 能 真正 有 收获 。 


另外 ， 区 块 链 技术 来 源 于 比特 币 ， 先 从 比特 币 讲 起 ， 可 以 避免 单纯 技术 描述 的 枯燥 乏味 。 所 以 ， 第 一 部 分 的 这 几 章 只 有 一 个 核心 主题 ， 就 是 告诉 你 区 块 链 产品 


加 密 货 币 就 是 货币 。 但 是 ， 这 一 点 要 


解释 清楚 却 是 大 费 周 章 ， 原 因 是 既 要 时 刻 避 免 使 用 太 多 的 专业 术语 ， 还 要 讲 透 原理 和 内 容 ， 对 于 我 这 样 的 编程 人 员 来 说 ， 这 样 做 确实 有 点 难度 。 


第 1 章 “加密 货币 就 是 货币 


本 书 除 特别 注 明 外 ， 所 讲述 的 “货币 ”不 是 法 币 ， 特 指 黄金 一 类 的 一 般 等 价 物 ， 属 于 数字 资产 。 


区 块 链 技术 最 著名 的 产品 就 是 比特 币 ， 它 是 一 种 加 密 货币 。 “加 密 货 和 


和 就 是 货币 ” 听 起 来 挺 “ 白 痴 的 ”。 但 仔细 想 想 ， 似 乎 暗含 着 “加 密 货币 可 能 不 是 货币 ”的 意思 ， 这 就 非常 值得 玩味 了 。 事 实 上 ，， 


在 我 接触 的 很 多 朋友 当中 ， 一 开始 认为 它 的 意思 是 后 者 的 更 多 。 包 括 我 自己 ， 也 是 经 过 一 段 时 间 的 探究 之 后 ， 才 认定 前 面 这 个 结论 的 。 


本 章 试图 用 最 直 白 的 语言 帮助 那些 没有 接触 过 加 密 货 


惯性 定律 不 仅 存在 于 物质 世界 ， 也 存在 于 人 类 的 认 知 世界 。 人 类 的 经 验 越 丰富 ， 理 解 新 事物 的 阻力 就 会 越 大 。 特 别 是 当 一 个 新 事物 出 现在 面前 ， 它 的 名 字 没 有 什么 特别 之 处 ， 技 术 本 身 也 不 是 什么 新 奇 
玩意 的 时 候 ， 如 果 说 它 是 颠覆 性 创新 ， 且 即将 改变 未 来 ， 那 就 着 实 让 人 费解 。 


6 的 读者 入 门 ， 架 起 人 类 思考 和 接纳 加 密 货币 的 桥梁 。 很 多 小 伙伴 ， 都 是 因为 最 先 了 解 了 比特 币 ， 进 而 一 发 不 可 收拾 ， 深 入 其 中 持续 探索 区 块 链 技 


术 的 。 所 以 ， 如 果 看 完 本 章 之 后 ， 你 有 了 那么 一 点 小 激动 ， 还 想 要 继续 探究 下 去 ， 那 我 的 目的 也 就 达到 了 。 


本 章 会 涉及 入 门 者 一 开始 就 会 碰 到 的 一 些 概念 ， 比 如 : 什么 是 加 密 货 


都 是 以 一 个 程序 员 的 角度 来 出 发 讲解 的 。 


1.1 加 密 货币 简 史 


65? 它 与 大 家 日 常 使 用 的 各 种 数字 币 究 竟 有 什么 区 别 ? 它 有 什么 优势 ， 为 什么 会 受到 如 此 吹捧 ? 等 等 。 对 于 这 些 问题 ， 本 章 基本 上 


首先 要 理解 的 是 ， 加 密 货币 是 一 种 数字 货币 。 早 在 比特 币 出 现 之 前 ， 


“数字 货币 ” “虚拟 货币 ” “电子 货币 ”等 就 已 经 出 现 了 ， 尤 其 以 “虚拟 货币 ”居多 ， 对 其 最 简单 的 理解 就 是 “货币 数字 化 或 虚拟 


化 ”。 这 里 的 货币 是 现实 中 的 法 币 ， 比 如 美元 、 人 民 币 ， 数 字 化 就 是 不 用 拿 钞票 ， 直 接 通 过 网 银 、 支 付 宝 等 就 可 以 支付 。 


后 来 ， 各 大 游戏 平台 提出 
其 实 就 是 “ 代 币 ”。 


了 游戏 币 的 概念 ， 采 用 的 是 通过 法 币 直接 兑换 的 方式 ， 玩 家 可 以 使 用 它 购 买 各 种 装备 。 接 着 ， 众 多 网 站 也 推出 了 各 种 币 ， 以 用 于 吸引 用 户 。 所 谓 的 数字 货币 ， 最 直观 的 解释 ， 


二 


近年 来 ， 比 特 币 的 出 现 ， 


代表 一 种 真正 的 可 以 称 为 “货币 ”的 数字 货 条 


每 一 样 都 不 是 普通 人 所 具备 的 。 


即便 这 些 技术 都 具备 了 ， 


6 诞生 了 ， 人 们 却 很 难 把 它 与 其 他 数字 货币 区 分 开 。 原 因 很 简单 ， 一 方面 ， 不 接受 的 惯性 非常 强 : 大 部 分 人 都 有 丰富 的 数字 货币 使 


经 验 ， 满 世界 都 是 “数字 货币 ”， 偏 偏 它 就 不 同 吗 ? 另 一 方面 ， 接 受 的 阻力 非常 大 : 理解 加 密 货币 需要 知道 点 P2P 网 络 是 怎么 回 事 ， 知 道 有 加 密 解密 技术 这 么 回 事 ， 最 好 还 能 了 解 点 数据 库 技术 ， 上 述 的 


但 是 要 想 实现 像 法 币 一 样 的 功能 和 特点 ， 也 不 是 几 个 人 脑 洞 大 开 ， 想 想 就 能 明白 的 。 所 以 ， 在 人 们 的 思维 里 一 切 “数字 货币 ”并 不 是 真正 的 货币 ， 而 仅仅 是 “ 代 币 ”而 


已 ，“ 加 密 货币 就 是 货币 ” 


而 令 人 费解 ， 让 人 难以 接受 。 


1.2 ”什么 是 加 密 货币 


我 在 网 上 搜索 了 一 下 这 个 问题 ， 非 常 奇 苑 的 是 ， 直 接 回答 这 个 问题 的 竟然 是 一 个 传销 币 (把 加 密 货币 当 作 巾 子 ， 通 过 传销 发 售 的 产品 ) ， 当 然 ， 内 容 也 没有 直接 回答 ， 


美元 、 人 民 币 等 由 银行 或 


我 们 所 说 的 “加 密 货币 ” 


币 来 定义 加 密 货币 : 


加 密 货币 ， 是 一 种 基于 点 对 点 网 络 (P2P 网 络 ) 、 没 有 发 行 机 构 、 


解读 如 下 。 


国 


家 发 行 的 纸币 ) 的 


区 别 。 可 见 ， 界 定 一 下 这 个 概念 ， 还 是 非常 有 必要 的 。 


， 英文 是 “cryptocurrency”， 也 有 人 在 百科 上 将 其 翻译 成 “密码 货币 ”， 可 以 解释 为 一 种 加 密 电 子 货币 (或 数字 货币 ) 


总 量 基 本 固定 的 加 密 电 子 通 货 。 


都 在 用 户 自己 的 电 


DN 


没有 发 行 机 


3) 总 量 基本 固 


1) P2P 网 络 : 这 个 已 经 不 是 新 鲜 概 念 了 ， 最 早 我 们 使 
六 上 ， 而 且 下 载 的 人 越 多 速度 就 越 快 。 


构 : 即 不 是 哪个 公司 、 银 行 或 


ia 
丰 


的 Bit 下 载 就 是 基 寺 


P2P 网 络 的 ， 现 在 很 多 下 载 工 


国 


家 控制 同时 还 要 防止 通货 膨胀 等 


非常 复杂 的 机 制 


素 ， 需 要 在 编程 中 使 


， 典 型 的 例子 就 是 比特 币 。 所 以 ， 我 们 不 妨 使 


和 


: 这 是 保证 加 密 货币 价值 的 一 种 策 


阁 ， 


、S 币 等 ， 这 些 虚 拟 币 没 有 固 


定数 量 ， 可 以 无 限 释放 。 


“ 物 以 稀 为 贵 ”， 任 何 东西 若 没 有 上 限 就 会 失去 它 的 吸引 力 。 关 于 这 一 点 ， 它 与 很 多 网 络 社 


区 使 


的 积分 是 有 


规则 〈 后 文 会 讲 到 的 共识 机 制 ) 来 实现 。 


只 是 谈 了 谈 加 密 货币 与 法 币 ( 像 


都 支持 。 它 的 好 处 就 是 分 布 式 下 载 (“ 去 中 心 化 ”) ， 也 就 是 没有 中 心服 务 器 ， 要 下 载 的 文件 


区 别 的 ， 比 如 : A 币 、C 币 、Q 


这 个 就 


4) 加 密 : 这 里 所 说 的 加 密 ， 不 是 用 户 使 用 的 输入 用 户 名 、 密 码 等 那 种 简单 的 权限 控制 ， 而 是 对 每 一 个 产生 电子 货币 本 身 的 交易 与 传输 的 加 密 。 密 码 学 本 身 就 很 复杂 ， 但 是 使 用 它 并 不 复杂 ， 明 
足够 了 。 
5) 电子 通货 : 是 指 加 密 货币 就 是 货币 ， 与 黄金 类 似 ， 可 以 自由 交易 ， 只 不 过 是 一 种 电子 (数字 ) 形式 而 已 。 那 么 像 A 币 、Q 币 之 类 的 就 不 是 货币 吗 ?” 不 是 ， 下 面 将 详细 解释 这 一 点 。 


1.3 ”加 密 货币 就 是 货 


加 密 货币 就 是 货 


类 比 一 下 法 币 ， 找 找 加 有 


币 ， 这 是 一 个 近乎 “废话 ”的 奇 苑 结论 ， 当 我 们 了 解 了 上 面 的 历史 和 概念 定义 之 


货币 与 “货币 ”的 共同 点 。 


1) 定量 : 法 币 通常 与 背 
长 。 


等 ) ， 以 防止 通货 


但 是 ， 一 些 网 站 提供 的 数字 币 是 没有 固 


2) 加 密 : 法 币 是 有 防伪 措施 的 ， 应 该 说 实物 防伪 的 最 高 级 只 


后 ， 理 解 起 来 就 会 容易 得 多 了 。 但 是 如 果 你 不 是 技术 人 人员， 理解 起 来 还 是 有 点 困 


后 的 黄金 或 所 谓 的 GDP 挂 钩 ， 算 是 相对 固定 可 以 算 作 绝 对 的 固 


(经 济 低迷 时 的 过 量 发 行 暂且 就 别 考虑 了 ) 。 加 密 货币 ， 


总 量 就 有 多 少 。 


定数 量 的， 一 般 作 为 法 币 的 代 币 ， 


户 购买 了 多 少 ， 


的 技术 就 应 


在 法 币 上 (不 过 ， 仍 然 可 以 伪造 ， 假 币 并 不 少见 ) 


， 通 过 验 钞 机 等 专门 


定数 量 ， 或 者 少量 的 增发 (可 以 弥补 一 些 丢失 的 


难 ， 那 么 现在 我 们 就 来 


的 验 钞 设备 可 以 验证 。 加 密 货币 的 加 密 技术 就 相当 于 防 


伪 技 术 ， 每 一 笔 交易 都 会 被 严格 加 密 ， 专 家 解释 说， 破解 加 密 货 币 是 理论 上 可 行 、 成 本 上 绝对 不 可 行 的 事情 ， 因 此 很 难 伪造 ， 同 时 ， 加 密 货币 的 验证 机 制 要 远 胜 法 币 ， 简 单 、 快 速 且 更 准确 。 

那么 ， 个 别 网 站 的 数字 币 就 不 是 这 样 的 ， 它 们 仅仅 是 一 串 数字 而 已 ， 管 理 员 可 以 修改 、 冻 结 ， 它 们 的 加 密 也 仅仅 是 用 户 登录 时 的 权限 控制 。 

3) 交易 : 货币 ， 也 称 为 通货 ， 被 称 为 一 般 等 价 物 ， 是 可 以 与 任何 商家 交换 ， 购 买 任何 东西 的 ， 这 是 货币 的 最 基本 属性 。 加 密 货 币 也 是 如 此 ， 你 可 以 支付 给 任何 一 方 ， 加 密 货币 都 会 安全 到 达 ， 而 不 用 担 
心 被 黑客 劫持 或 破解 ， 也 不 用 担心 价值 会 减少 或 蒸发 。 

但 是 ， 一 些 网 站 的 数字 币 是 绝对 没有 这 种 功能 的 ， 只 能 在 网 站 内 部 进行 交易 ， 离 开 了 网 站 就 没有 任何 价值 了 。 有 些 商城 可 以 使 用 积分 购物 ， 看 似 可 以 在 很 多 网 站 之 间 进 行 交易 ， 其 实 仍然 是 他 们 自己 的 


网 站 。 当 然 ， 网 站 如 果 与 第 三 方 签订 了 协议 ， 规 定 它 的 数字 币值 多 少 法 币 ， 也 可 以 与 其 他 | 
因为 无 法 监督 、 控 制 ， 无 法 保证 绝对 信任 。 


我 不 会 ， 


14 加 密 货 币 可 靠 吗 


从 上 面 的 讨论 中 ， 我 们 可 以 了 解 加 密 货币 是 怎么 回 事 了 ， 但 是 你 可 能 仍然 会 怀疑 加 密 货币 的 实 
动用 很 多 技术 和 理论 。 还 好 ， 这 些 技术 和 理论 ， 都 是 目前 成 熟 的 技术 。 您 只 要 认为 它们 是 可 靠 的 ， 那 么 下 面 的 解释 就 很 好 理解 ， 不 然 ， 要 想 说 服 自己 
难 的 。 
1 去 中 心 化 

首先 我 们 需要 明白 什么 是 “中 心 化 ” 。 目 前 ， 我 们 通过 浏览 器 浏览 的 各 大 网 站 ， 都 是 中 心 化 的 ， 必 须 有 一 台 或 多 台 服 务 器 ， 将 我 们 浏览 
我 们 也 就 无 法 访问 了 。 中 心 化 的 东西， 一切 都 被 某 个 组 织 或 公司 控制 着 。 


去 中 心 化 ， 更 确 


是 一 样 的 ) 网 络 中 的 每 一 台电 脑 都 是 平等 的 ， 任 何 


切 的 说 应 该 称 为 分 布 式 ， 是 基于 P2P 网 络 的 ， 没 有 一 台 机 器 是 作为 中 心 化 的 服务 器 的 功能 ， (又 或 者 说 ， 任 何 一 台 机 器 都 


看 第 11 章 中 的 源码 分 享 。 


这 是 加 密 货币 的 交易 通道 ， 是 网 络 基础 ， 可 以 实现 无 障碍 交易 。 只 


2. 加 密 解 密 
我 们 已 经 有 了 可 以 自由 通行 的 路 线 或 航道 ， 但 是 这 些 航 道 安全 吗 ? 有 没有 强盗 ?被 劫持 了 、 破 解 了 ， 
时 刻 等 待 出 击 呢 。 
这 就 需要 使 用 严格 的 加 密 解 密 技术 。 还 好 ， 加 密 解密 技术 ， 也 是 网 络 世界 普遍 使 用 的 技术 ， 而 且 已 经 成 熟 使 用 了 这 么 多 年 。 从 理论 上 讲 ， 加 密 货 和 


9 内 容 整 理 好 ， 提 供给 我 们 浏览 。 


备 中 心 化 的 服务 器 功能 ， 
一 台 掉 线 、 宕 机 ， 都 不 会 影响 整个 网 络 继续 运行 。 如 果 大 家 都 信任 这 个 网 络 ， 那 么 这 个 网 络 永远 都 不 会 死 掉 ， 现 在 的 比特 


站 进行 交易 ， 但 是 这 种 交易 ， 本 质 上 仍然 是 法 币 交 易 。 不 过 ， 即 便 如 此 ， 这 个 协议 估计 也 没有 人 愿意 签订 ， 至 少 


性 ， 它 真 的 可 靠 吗 ? 这 是 最 初 很 多 人 都 会 问 的 问题 。 结 论 当 然 是 可 靠 的 ， 但 是 要 解释 清楚 


为 什么 ， 就 要 


接受 加 密 货币 比 一 些 网 站 的 数字 币 更 可 靠 ， 那 还 是 很 


如 果 服 务 器 发 生 了 故障 ， 那 么 


为 一 个 问题 的 两 个 极端 ， 效 果 却 


可 以 上 网 ， 任 何 时 间 、 任 何 地 点 ， 都 可 以 介入 这 个 交易 网 络 ， 把 加 密 货 币 支付 到 世界 的 任何 一 个 角落 。 


和 网 络 基本 上 就 是 如 此 。 


人体 请 


怎么 办 ?更 何况 ， 我 们 这 条 航道 ， 要 通过 一 家 家 私人 住所 (个 人 或 组 织 的 电脑 ) ， 或 许 有 个 黑客 正 


和 的 交易 地 址 、 每 一 笔 交易 等 都 是 加 密 解 密 中 的 一 部 


分 ， 破 解 一 个 毫 无 意义 ， 全 部 破解 又 相当 不 易 ， 加 之 P2P 网 络 节点 众多 ， 破 解 一 个 节点 是 没有 任何 价值 的 ， 所 以 加 密 货币 的 安全 级 别 应 该 是 目前 最 高 的 。 


这 是 加 密 货币 的 安全 保障 。 有 了 这 一 点 ， 我 们 才能 放心 地 支付 加 密 货币 ， 而 不 用 担心 丢失 、 被 盗 ， 买 家 才能 有 支付 交易 的 基础 动力 。 关 于 加 密 解密 技术 ， 可 以 阅读 第 12 章 以 及 第 四 部 分 的 第 24 章 。 


3. 区 块 链 


看 到 


我 们 可 以 顺利 支付 了 ， 但 是 另 一 个 担忧 又 来 了 ， 怎 么 保证 卖家 一 定 收 到 了 ， 或 者 一 定 没有 收 到 ?万 一 卖家 赖账 ， 说 没有 收 到 钱 怎 么 办 ? 这 种 信任 机 制 由 谁 来 保证 ? 


回答 是 区 块 链 。 这 个 才 是 加 密 货币 的 独创 ， 比 特 币 的 创新 发 明 ， 不 过 区 块 链 使 用 的 技术 却 是 简单 的 数据 库 技 术 (当然 ， 也 可 以 使 用 文件 存储 ， 不 过 多 数 应 该 都 是 数据 库 ) 。 区 块 链 的 本 质 就 是 存储 在 数 


据 库 里 的 交易 数据 ， 其 结构 是 每 一 条 记录 都 会 记录 前 一 条 


区 块头 的 散 列 值 ， 从 而 可 以 实现 往 前 追溯 ， 直 到 第 一 个 创 世 区 块 。 


更 重要 的 是 ， 这 个 数据 库 在 P2P 网 络 中 是 分 布 式 存储 的 ， 每 一 个 节点 都 会 保存 一 份 复制 备份 ， 每 一 个 人 都 可 以 公开 访问 ， 查 看 交易 记录 。 也 就 是 说 ， 不 仅 交 易 双方 能 看 到 交易 结果 ， 整 个 网 络 节点 都 能 


， 公 开 、 透 明 、 可 追溯 ， 让 你 不 得 不 信 。 


这 是 加 密 货币 的 信用 保障 。 任 何 经 济 行为 ， 若 没有 信任 作为 基础 ， 都 不 可 能 达成 。 加 密 货币 这 个 独创 性 ， 为 构建 公开 、 透 明 、 可 追溯 的 信用 体系 打开 了 一 扇 大 门 ， 各 大 公司 、 组 织 、 个 人 之 所 以 痴迷 于 


加 密 货币 ， 都 是 因为 这 个 创新 技术 背后 的 无 限 可 能 性 。 后 面 ， 我 会 继续 分 享 亿 书 区 块 链 的 实现 ， 请 阅读 第 16 章 “区 块 链 ”。 
4 共识 机 制 

有 航道 ， 又 安全 、 可 信 ， 是 不 是 这 些 就 足够 了 ?还 有 一 个 关键 的 问题 是 ， 这 么 多 节点 维护 一 个 相同 的 数据 库 ， 到 底 哪 个 节点 写 入 的 数据 库 会 被 接受 ， 该 如 何 有 序 地 运作 呢 ? 还 有 ， 发 行 的 加 密 货 币 是 固 
定数 量 的 ， 怎 么 保证 某 个 节点 不 “调皮 捣蛋 ”地 自己 增加 数量 呢 ? 在 利益 面前 ,什么 人 、 什 么 事情 都 有 可 能 会 出 现 。 


这 个 问题 的 解决 之 道 就 是 所 谓 的 “共识 机 名 


页 中 


起 于 


就 


进入 这 个 行业 投资 或 创 
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需要 重点 编码 的 地 方 ， 也 是 加 密 货币 开发 的 


特别 是 DPoS 机 制 ， 基 本 上 就 是 股份 制 公司 


这 是 加 密 货币 的 运行 规则 。 是 将 前 面 的 通 


的 股东 投票 机 制 ， 亿 书 使 


判 ”， 包 括 工作 量 证 明 机 制 (PoW) 、 股 权证 明 机 制 (PoS) 、 授 权 股 权证 明 机 制 (DPos) 等 ， 类 似 于 大 家 商讨 问题 ， 集 体 决策 时 的 原则 和 规矩 。 这 才 是 加 密 
难点 所 在 。 


的 就 是 这 种 算法 机 制 。 具 体 请 阅读 第 17 章 。 


技术 进行 融合 创新 的 地 方 ， 若 不 了 解 这 个 部 分 ， 区 块 链 开发 就 无 从 谈 起 。 


最 后 ， 上 述 技术 并 不 是 相互 独立 的 ， 而 是 相互 配合 、 相 互 支撑 ， 通 过 共识 机 制 成 为 一 个 整体 ， 实 现 了 加 密 货币 绝对 不 用 某 个 机 构 发 行 也 能 保证 其 绝对 安全 的 支付 和 交易 。 


本 章 简单 描述 了 区 块 链 产品 


比特 币 的 概念 和 特征 ， 并 通过 其 与 传统 货币 的 对 比 讲解 了 加 密 货 币 的 本 质 属 性 ， 并 从 技术 的 角度 描述 了 加 密 货 币 的 安全 性 和 可 行 性 ， 进 而 让 我 们 真正 认识 到 “加 密 货 币 


货币 ”这 个 概念 ， 为 以 后 的 进一步 学 习 英 定 了 良好 的 理论 基础 。 


截至 目前 ， 以 比特 币 为 核心 的 网 络 、 经 济 生态 已 经 影响 和 饥 布 全 球 。 想 象 一 下 ， 一 个 高 度 自治 的 网 络 会 给 我 们 的 未 来 带 来 什么 样 的 变革 (未 来 趋势 ) ? 我 们 能 使 用 区 块 链 做 点 什么 (应 用 场景 ) ? 如 果 


参考 


止 ， 有 什么 需要 注意 的 〈 风 


《 亿 书 白皮书 v2.0》: http://ebookchain.org/ebookchain.pdf 
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第 2 章 ”区 块 链 ， 承 载 人 类 信用 的 基石 


忆 :| 


定 会 被 推翻 的 。” 霍 尔 巴赫 的 话 则 更 加 直 白 : 


第 1 章 的 内 容 在 网 上 一 经 发 布 就 吸引 了 很 多 关注 ,说明 很 多 小 伙伴 因为 对 加 密 货 


仁和 方法 提示 ) ? 关于 这 些 问题 的 解答 参见 第 2 章 。 


6 不 了 解 ， 或 者 有 误解 ， 所 以 才 会 敬而远之 ， 错 失 良 机 。 


继续 第 1 章 的 内 容 ， 本 章 仍 将 通过 直 白 的 语言 来 讲解 技术 原理 。 所 涉及 的 内 容 包括 现实 世界 的 内 在 驱动 力 、 未 来 趋势 、 应 用 场景 和 风险 提示 等 。 


利益 ， 现 实 世界 的 内 在 驱动 力 


人 活着 到 底 是 为 了 什么 ”我 们 每 个 人 可 能 都 问 过 自己 这 个 问题 。 我 们 有 时 候 距 路 满 志 ， 有 时 候 又 崇尚 与 世 无 争 ， 无 忧 无 虑 。 但 在 纷繁 复杂 的 真实 世界 里 ， 我 们 总 会 被 某 个 力量 牵引 着 ， 挣 脱 不 开 ， 欲 喷 


不 能 。 


这 个 力量 就 是 对 利益 的 追求 。 


人 对 利益 的 追求 源 于 人 的 本 性 。 关 于 利益 的 名 言 也 是 值得 我 们 学 习 和 思考 的 。 马 克 思 说 过 : “人 们 奋斗 所 争取 的 一 切 ， 都 同 他 们 的 利益 有 关 。” 列 宁 也 说 : “几何 公理 要 是 触犯 了 人 们 的 利益 ， 那 也 一 
“利益 是 人 类 行动 的 一 切 动力 。” 


所 以 ， 我 们 不 但 不 用 扣 谈 利益 ， 而 且 最 好 把 利益 作为 我 们 分 析 和 思考 产品 开发 设计 的 根本 因素 。 如 此 一 来 ， 再 理解 人 们 为 何 对 加 密 货币 趋 之 若 爸 就 轻松 多 了 。 


2.2 信用， 决定 着 利益 转移 的 方向 


与 他 人 谈 起 区 块 链 时 ， 不 止 一 次 谈 到 “信用 ”这 个 话题 ， 每 一 次 我 都 会 有 更 加 深刻 的 理解 。 第 一 次 明确 地 谈 信 用 ， 起 源 于 一 个 公司 反复 地 声明 一 件 事情 ， 但 是 除了 声明 ， 也 没有 更 好 的 办 法 向 公众 表明 
自己 ， 反 而 越 声明 越 被 动 。 于 是 ， 我 在 网 上 发 表 了 一 篇 文章 《请 尽早 把 你 的 信誉 区 块 链 化 》 ( 见 2.7 节 ) ， 其 核心 观点 是 学 习 区 块 链 的 处 理 方式 积累 个 人 或 公司 的 信用 。 


这 里 再 次 提 及 这 个 话题 ， 原 因 是 我 在 写 下 前 面部 分 的 时 候 ， 突 然 发 觉 单 纯 地 讲 未 来 趋势 会 如 何 没有 任何 说 服 力 ， 其 中 缺少 潜在 的 源 动 力 。 另 外 ， 我 经 常 说 这 样 一 段 话 : 


“…- 比 特 币 价格 xx x x 元 (xxx 美 元 ) 。 为 什么 一 个 赁 空 设计 出 来 的 加 密 货 币 会 如 此 受 追 捧 ? 为 什么 微软 、IBM 等 巨头 纷纷 进入 ? 为 什么 尝试 了 解 比特 币 的 技术 人 员 ， 都 会 被 深 深 吸 引 ? 它 到 底 有 什 
么 诱 人 之 处 ? 《Nodejs 区 块 链 开发 》 正 在 尝试 回答 这 些 问 题 。” 


可 当时 ， 我 还 没 想 过 如 何 正面 回答 为 什么 。 今 天 我 发 现 ， 在 这 里 回答 应 该 是 最 好 的 时 候 。 


1. 信 用 是 交易 的 基础 


我 们 什么 时 候 才 会 讲 到 “信用 ”? 什么 时 候 才 会 考查 他 人 的 “信用 ”? 很 显然 ， 就 是 准备 与 他 人 进行 “交易 ”的 时 候 。 可 以 说 ， 信 用 是 交易 的 前 提 ， 没 有 信用 就 没有 交易 ， 有 了 信用 才 有 可 能 交易 。 


经 济 社会 ， 就 是 一 个 信用 社会 。 如 果 信 用 不 在 ， 那 么 一 切 都 将 回归 物 物 交换 ， 甚 至 是 自给 自足 的 原始 社会 。 因 为 交易 风险 太 大 ， 人 类 保护 自己 利益 (求生 的 本 性 ) 和 追求 自己 利益 最 大 化 (不 满足 的 本 
性 ) 的 欲望 ， 会 促使 人 们 放弃 交易 。 因 此 ， 信 用 对 于 个 人 和 企业 而 言 同等 重要 。 


柯 


2. 信 用 是 积累 的 过 程 


信用 的 建立 不 是 一 朝 一 夕 的 事情 。 如 果 深 入 思考 ， 安 全 、 公 开 、 可 追溯 ， 才 是 人 类 建立 信任 的 基本 要 素 。 没 有 人 一 见面 就 说 “我 信任 你 ”的 ， 也 没有 人 遮 遮掩 掩 还 能 赢得 他 人 信任 的 ， 这 就 是 所 谓 
的 “路 遥 知 马力 ， 日 久 见 人 心 ”。 


这 里 隐 含 的 意思 就 是 ， 对 于 另 一 个 人 的 信用 ， 每 个 人 都 会 在 自己 的 心里 建立 一 个 “区 块 链 ”。 一 旦 有 交易 往来 ， 就 会 自觉 回忆 过 往 的 点 点 滴 滴 (追溯 ) ， 并 对 当下 的 交易 进行 风险 评估 。 如 果 是 重大 交 
易 ， 那 么 这 个 人 可 能 还 要 求助 于 第 三 方 ， 通 过 他 人 的 “区 块 链 ”进一步 进行 认证 。 


3. 信 用 的 本 质 是 解决 了 信息 不 对 称 


人 们 没有 办 法 一 开始 就 信任 你 ， 是 因为 彼此 “信息 不 对 称 。”， 没 有 足够 信息 证 明 自 己 不 会 在 你 “利益 最 大 化 ”的 过 程 中 “被 牺牲 掉 ”。 


“信息 不 对 称 ” 表 现在 三 个 方面 : 一 是 ， 我 的 信息 ， 你 不 知道 ; 二 是 ， 我 的 信息 ， 你 知道 但 无 法 识别 ; 三 是 ， 你 知道 我 的 信息 ， 也 可 以 辨别 ， 但 是 无 法 控制 。 


一 些 经 济 学 家 对 此 进行 了 大 量 研究 ， 他 们 认为 ， 信 息 不 对 称 造 成 了 市 场 交易 双方 的 利益 失衡 ， 影 响 了 社会 公平 、 公 正 的 原则 ， 以 及 市 场 配置 资 源 的 效率 ， 并 且 提出 了 各 种 解决 方法 ， 但 是 仍然 无 法 彻底 
解决 这 个 问题 。 


比特 币 的 出 现 ， 让 人 们 真正 找到 了 一 条 切实 可 行 的 途径 。 为 什么 说 比特 币 会 火 ， 人 人 都 觉得 它 有 价值 ”是 因为 它 可 信 (至 少 目前 是 ) ! 为 什么 它 可 信 ， 是 因为 区 块 链 、 加 密 技 术 和 分 布 式 网 络 的 组 合 ， 
让 交易 变 得 安全 、 公 开 、 可 追溯 (基本 原理 参见 1.4 节 的 相关 分 析 ) 。 


赂 


所 以 ， 区 块 链 承载 的 就 是 信用 ， 是 一 个 不 需要 政府 、 银 行 或 财团 抵押 担保 的 信用 。 如 果 没 有 政府 保 
币 和 那些 真正 的 加 密 货币 会 火 的 根本 原因 。 


， 法 币 将 一 文 不 值 。 如 果 没 有 区 块 链 ， 比 特 币 也 将 一 文 不 值 。 这 就 是 区 块 链 的 价值 所 在 ， 也 是 比特 


换 名 话说， 纯粹 编程 实现 的 加 密 货 币 可 以 让 “利益 ”按照 设 定 的 规则 进行 转移 (交易 ) ， 最 终 的 结局 是 人 类 纷纷 参与 其 中 ， 让 这 个 盘子 越 来 越 大 。 现 在 你 所 看 到 的 比特 币 ， 就 是 这 个 结果 ， 社 会 各 界 都 
预测 比特 币 将 死 ， 可 结果 却 是 越 来 越 红火 。 


2.3 ”未 来 趋势 


比特 币 之 前 ， 人 类 从 来 都 无 法 完全 控制 “利益 ”的 走向 ， 比 特 币 之 后 ， 人 们 终于 可 以 对 “利益 ”转移 进行 编程 处 理 ， 这 将 给 人 类 的 未 来 带 来 无 限 的 可 能 。 这 种 编程 技术 就 是 区 块 链 。 


去 中 心 化 、 分 布 式 存在 以 及 人 类 社会 的 基本 形态 ， 是 个 体 交换 的 基本 前 提 。 之 所 以 区 块 链 被 提出 来 ， 不 是 因为 这 项 技术 有 多 先进 ， 而 是 现 有 的 技术 过 于 落后 。P2P 网 络 、 加 密 解 密 和 分 布 式 存储 等 技术 
的 出 现 ， 都 是 人 类 在 某 个 阶段 为 解决 特定 问题 而 设计 出 来 的 ， 组 合 在 一 起 成 为 区 块 链 技 术 ， 开 发 出 各 类 加 密 货 币 ， 更 接近 于 人 类 的 本 源 。 


一 切 违背 人 性 的 东西 都 将 被 颠覆 。 每 一 个 人 都 不 想 被 限制 。 把 你 的 命运 交 到 第 三 方 手 里 ， 任 由 他 摆布 ， 你 必 不 乐意 。 所 以 ， 以 服务 器 为 中 心 的 各 类 中 心 化 的 应 用 都 将 逐步 走向 终结 ， 这 仅 是 时 间 问 题 。 


那些 去 中 心 化 的 应 用 ， 才 是 真正 符合 人 性 的 应 用 ， 它 们 必 将 占据 主流 ， 抢 占 先 机 。 至 于 ， 是 不 是 比特 币 或 其 他 的 区 块 链 产品 根本 不 重要 ， 只 要 它 能 让 你 无 障碍 地 进行 交换 (人 类 无 处 不 交换 ， 交 换 信 
息 、 金 钱 、 财 富 等 ) 才 是 重点 。 


比特 币 为 我 们 进入 新 世界 提供 了 一 个 样板 。 全 新 的 互联 网 时 代 已 经 来 临 ， 只 是 尚 处 在 初级 阶段 ， 那 些 真正 被 大 众 接受 的 应 用 还 不 存在 。 目 前 ， 所 有 的 应 用 仍然 显得 那么 高 大 上 ， 就 像 最 初 的 BP 机 、 大 哥 
大 或 智能 手机 ， 只 能 作为 少 部 分 人 的 玩具 和 奢侈 品 。 但 是 ， 很 快 它们 会 遍布 这 个 世界 。 


此 ， 区 块 链 是 未 来 的 互联 网 ， 互 联网 的 未 来 。 


2.4 应 用 场景 


我 们 的 目标 是 利用 区 块 链 技术 开发 应 用 ， 所 以 了 解 它 的 应 用 场景 将 会 有 很 大 的 帮助 。 总 的 来 说 ， 这 项 技术 可 以 应 用 在 以 下 几 个 方面 。 


(1) 转账 支付 


这 个 应 该 是 最 基本 的 功能 ， 很 多 加 密 货 币 ， 例 如 比特 币 ， 本 身 的 目标 就 是 实现 没有 第 三 方 的 直接 支付 ， 所 以 将 其 应 用 于 转账 、 支 付 、 借 贷 ， 都 是 简单 、 轻 松 的 事情 。 特 别 是 当 加 密 货 币 之 间 可 以 直接 互 
相 兑 换 之 后 ， 未 来 或 许 再 也 见 不 到 有 独立 存在 的 第 三 方 支付 机 构 了 。 


(2) 资金 结算 


区 块 链 本 身 的 结构 体系 就 是 一 个 很 好 的 结算 系统 ， 由 于 网 络 遍布 世界 各 地 ， 跨 境 支付 与 结算 也 是 非常 容易 的 事情 。 当 前 的 银行 结算 体系 非常 复杂 ， 每 个 机 构 都 有 自己 的 记 账 ， 结 算 难 度 大 ， 周 期 长 。 于 
是 有 人 联合 众多 机 构 ， 采 取 联 盟 链 的 方式 ， 引 入 区 块 链 技术 ， 从 而 大 大 降低 了 结算 成 本 ， 缩 短 了 结算 周期 。 


(3) 智能 合约 


智能 合约 将 是 未 来 重要 的 发 展 方向 。 所 谓 的 智能 合约 ， 就 是 “合约 智能 化 ”， 其 主要 特点 是 : 合同 条 款 不 可 算 改 ， 有 效 性 能 够 得 到 保障 ; 合同 制定 和 执行 的 全 过 程 透明 公开 ， 便 于 监督 ;合同 的 执行 过 
程 可 编程 ， 能 够 自动 执行 ， 不 受 干预 。 所 以 ， 这 将 改变 未 来 的 契约 方式 ， 促 使 社会 变 得 更 加 公开 、 公 平 、 公 正 。 


(4) 身份 认证 


户 身份 认证 与 识别 是 银行 规避 反 洗 钱 等 违法 行为 的 必要 手段 ， 各 国 商业 银行 为 此 不 断 投入 资源 ， 以 加 强 信用 审核 及 客户 征 信 ， 耗 费 了 大 量 的 人 力 物 力 。 如 果 采 用 区 块 链 技 术 ， 则 可 以 促进 金融 领域 进 
一 步 标准 化 用 户 身份 数据 的 存储 ， 从 而 在 保证 数据 安全 的 同时 ， 实 现 信息 共享 ， 减 少 重复 审核 过 程 。 


(5) 电子 商务 


大 型 的 电子 商务 网 站 ， 一 般 都 会 涉及 仓储 、 物 流 、 交 易 和 支付 ， 每 一 个 环节 都 需要 大 量 的 协作 和 资金 结算 。 特 别 在 支付 环节 ， 目 前 都 是 基于 有 第 三 方 存在 的 中 心 化 的 支付 系统 ， 存 在 与 银行 资金 结 
慢 、 容 易 遭 受 各 类 黑客 攻击 等 问题 。 使 用 区 块 链 技术 ， 通 过 多 重 签名 ， 就 可 以 简单 地 抛 开 第 三 方 ， 实 现 用 户 与 商家 的 直接 支付 ， 大 大 降低 了 电子 商务 网 站 的 运营 成 本 和 操作 风险 ， 同 时 也 提高 了 用 户 支付 的 
安全 性 。 


(6) 版 权 保护 


数字 出 版 盗版 猩 狐 ， 网 络 小 说 、 网 络 游戏 、 音 乐 、 视 频 、 图 片 等 资源 在 没有 授权 的 情况 下 ， 被 大 量 免 费 传 播 ， 与 之 相关 的 创作 者 和 运营 机 构 直 接 蒙受 巨大 损失 ， 这 些 问 题 打击 了 优秀 作者 的 创作 激情 ， 
提高 了 运营 机 构 的 操作 成 本 ， 阻 碍 了 人 类 知识 的 创新 发 展 。 通 过 区 块 链 技术 确 权 数 字 出 版 物 ， 可 以 更 加 直接 地 接受 读者 和 用 户 的 付费 ， 并 使 用 智能 合约 ， 自 动 解决 许可 问题 ， 从 而 在 艺术 家 和 用 户 之 间 建 立 
更 加 直接 的 互动 关系 ， 为 人 类 的 创作 增添 新 动力 。 


(7) 证 券 交易 


股票 等 证 券 交 易 的 结算 时 间 较 长 ， 如 果 引 入 区 块 链 技术 ， 那 么 股票 交易 日 和 交割 日 的 时 间 间 隔 可 以 从 1 ~ 3 天 缩减 为 10 分 钟 ， 从 而 提高 了 交易 的 效率 和 可 控 性 ， 同 时 降低 了 交易 行为 的 风险 。 而 且 交 易 方 
身份 、 交 易 量 等 信息 也 被 实时 记录 在 区 块 链 上 ， 有 利于 证 券 发 行者 提高 决策 效率 ， 也 有 利于 监管 维护 ， 避 免 暗箱 操作 。 


(8) 贸易 金融 


传统 的 供应 链 金融 或 贸易 金融 业务 流程 高 度 依赖 人 工 ， 包 括 大 量 审阅 、 验 证 交易 单据 及 纸 质 文件 的 环节 ， 不 但 人 力 成 本 高 ， 各 个 环节 出 现 失误 的 风险 也 很 大 ， 如 果 使 用 区 块 链 管理 这 些 流程 ， 则 可 以 降 
低 人 力 等 成 本 ， 提 高 效率 和 透明 度 ， 降 低 欺诈 风险 和 人 工 工作 失误 的 风险 。 


(9) 物 联网 和 大 数据 


物 联 网 和 大 数据 的 主要 特点 都 是 分 布 式 存在 ， 所 以 同样 非常 适合 使 用 区 块 链 技术 。 通 过 区 块 链 技术 ， 物 联网 、 大 数据 、 云 存储 等 这 类 分 布 式 系统 ， 各 个 节点 高 度 自治 ， 彼 此 之 间 又 智能 协同 ， 由 于 没有 
中 央 控 制 系统 来 识别 对 方 ， 节 点 将 能 够 独立 自主 地 与 对 方 进行 联系 ， 管 理 软件 更 新 、 软 件 错误 或 控制 能 源 消耗 ， 协 同 能 力 得 到 强化 。 同 时 安全 性 得 到 加 强 ， 很 难 引起 系统 性 破坏 和 数据 大 范围 丢失 。 


2.5 ”风险 提示 


读 到 这 里 ， 如 果 你 已 摩拳擦掌 ， 想 要 大 干 一 番 ， 不 妨 把 下 面 的 内 容 看 完 ， 让 我 先 泼 点 冷水 ， 以 便 让 你 保持 清醒 的 头脑 。 


区 块 链 技术 仍 处 在 发 展 阶段 ， 充 满 了 各 种 神话 ， 也 存在 着 各 种 骗局 ， 可 谓 是 “天 使 与 魔鬼 同 在 ”。 有 很 多 小 伙伴 一 开始 进来 时 会 被 各 种 诱惑 所 吸引 ， 其 中 不 乏 上 当 受 骗 者 。 这 里 就 简单 介绍 一 下 将 会 遇 
到 的 风险 ， 权 当 提醒 。 


1. 远 离 传销 币 


所 谓 传 销 币 ， 第 1 章 中 曾 提 到 过 ， 就 是 把 加 密 货币 当 作 核 心 产品 (有 的 甚至 什么 都 没有 ， 就 一 个 空 网 站 ) ， 通 过 传销 发 售 的 加 密 货 币 。 这 类 币 很 少 出 现在 主流 加 密 货币 社区 ， 因 为 一 旦 出 现 就 会 被 经 验 
富 的 币 圈 大 咖 识 破 。 所 以 ， 如 果 有 人 向 你 推销 某 某 币 ， 并 向 你 承诺 诱 人 的 收益 时 ， 干 万 当心 ， 你 遇 到 的 可 能 就 是 传销 币 , 如 “MMM” 。 


这 类 币 的 诱惑 性 之 所 以 非常 大 ， 是 因为 他 们 也 提供 了 真正 的 加 密 货币 (从 上 面 的 分 析 中 应 该 知道 这 个 并 不 难 ) 。 真 正 的 加 密 货币 都 是 开源 的 ， 比 如 亿 书 还 提供 了 详细 的 源码 解析 ， 很 多 人 都 可 以 照 猫 画 
虎 做 一 个 。 但 是 ， 后 续 技 术 上 没有 任何 的 改进 ， 只 能 是 死路 一 条 。 


2. 远 离 空 壳 币 


所 谓 的 空 壳 币 ， 就 是 把 加 密 货 币 当 作 核 心 产品 ， 通 过 快速 众 筹 的 方式 来 骗 钱 的 加 密 货币 。 空 壳 币 与 传销 币 的 本 质 相同 ， 只 不 过 它 是 公开 众 筹 ， 至 于 会 怎么 样 ， 就 不 得 而 知 了 。 


空 壳 币 的 突出 表现 就 是 ， 从 源码 建立 到 众 筹 的 时 间 比 较 短 ， 各 方面 信息 粗制滥造 。 每 天 都 有 很 多 的 新 币 出 现 ， 有 的 创 世 帖 、 和 白皮书 几乎 一 样 ， 没 有 任何 改进 。 


3. 避 免 操 作风 险 


叫 


上 面 提 到 的 两 点 是 新 手 入 行 时 可 能 遇 到 的 风险 。 一 旦 找到 了 值得 信赖 的 产品 ， 就 会 进入 操作 风险 的 层面 ， 下 面 简单 归纳 一 下 。 


(1) 选择 官方 钱包 


使 用 其 他 人 提供 的 或 者 从 网 上 下 载 的 钱包 ， 都 可 能 带 有 木马 ， 风 险 更 大 。 有 些 钱包 在 安装 使 用 的 时 候 ， 会 被 杀毒 软件 提示 和 阻止 ， 通 常 需要 用 户 手动 将 其 加 入 白 名 单 。 这 就 更 加 充满 迷惑 性 ， 携 带 木 马 
病毒 的 客户 端 基本 也 能 蒙混 过 关 了 。 


(2) 保护 钱包 私 钥 


私 钥 就 像 你 的 银行 密码 一 样 ， 不 能 泄漏 或 丢失 ， 否 则 基本 没有 办 法 找 回 。 另 外 ， 加 密 货币 的 钱包 私 钥 比 密码 更 复杂 ， 很 长 一 串 字符 不 易 记 忆 。 将 其 保存 在 电脑 上 怕 被 盗 ， 将 其 保存 在 纸 上 又 怕 丢 失 ， 但 
是 无 论 如 何 都 要 自己 保存 好 ， 那 是 自己 财产 的 钥匙 。 


(3) 做 好 钱包 备份 


钱包 数据 中 保存 的 就 是 自己 的 钱 ， 一 定 要 定期 备份 以 免 委 失 。 特 别 是 在 清理 电脑 或 更 换 系统 之 前 ， 要 确保 钱包 数据 已 经 备份 。 


看 完 上 述 问题 ， 大 家 是 否 觉得 很 受 打击 ? 怎么 会 有 这 么 多 问题 呢 ?” 这 个 行业 还 能 待 吗 ? 为 了 回答 这 个 问题 ， 欢 迎 大 家 参考 我 之 前 在 亿 书 开发 者 群 里 分 享 过 的 文章 《天 使 投资 人 的 骗子 论 》 ( 见 2.7 节 ) 。 


本 章 重 新 思考 了 “利益 ”转移 规则 的 程序 化 进程 、 趋 势 和 风险 。 那 么 ， 都 有 哪些 利益 转移 规则 ， 它 们 有 什么 优 缺 点 ， 亿 书 计划 又 如 何 改进 ， 相 关内 容 参 见 第 3 章 。 


《请 尽早 把 你 的 信誉 区 块 链 化 》: http://chainclub.org/topic/5/ 请 尽早 把 你 的 信誉 区 块 链 化 


《天 使 投资 人 的 骗子 论 》: http://8btc.com/thread-32135-1-1.html 


《利益 ， 网 络 释 义 》: http://baike.baidu.com/ 


《区 块 链 到 底 有 哪些 场景 和 市 场 前 景 》: http://www.tmtpost.com/2430265.html 


第 3 章 ”共识 机 制 ， 可 编程 的 利益 转移 规则 


前 面 两 章 曾 经 说 过 ， 区 块 链 产品 都 是 去 中 心 化 的 ， 去 中 心 化 的 基础 就 是 P2P 节 点 众多 ， 那 么 如 何 吸引 


库 ， 那 么 如 何 决定 写 入 哪个 节点 ? 何 时 写 入 ? 一 旦 写 入 ， 又 如 何 保证 不 被 其 他 的 节点 更 改 (不 可 逆 ) 呢 ? 回答 这 些 问题 的 答案 就 是 共识 机 制 。 


共识 机 制 ， 可 编程 的 利益 转移 规则 。 谈 到 共识 机 制 ， 不 得 不 说 的 是 ， 编 程 开发 这 么 多 年 
但 是 没有 任何 一 种 方式 能 与 区 块 链 的 共识 机 制 相提并论 。 每 一 个 


区 块 链 产品 本 身 就 是 一 个 小 


本 章 将 回答 “为 什么 区 块 链 产品 无 须 监管 ”， 主 要 内 容 包括 机 制 的 作用 、 共 识 机 制 的 种 类 、 它 们 各 自 的 优 缺 点 以 及 亿 书 的 改进 计划 。 


3.1 机制， 左右 产品 走向 的 根源 


“机 制 ” 一 词 原 指 机 器 的 构造 和 动作 


原理 ， 在 社会 学 中 可 以 表述 为 “协调 各 个 部 分 之 


我 在 工作 中 曾 遇 到 过 一 位 好 领导 ， 他 非常 公道 正派 ， 一 切 事情 按 规矩 来 办 ， 处 理 问题 


是 常 有 的 事情 ， 人 人 都 能 收获 满 满 。 后 来 


类 似 的 情况 可 能 很 多 人 都 遇 到 过 ， 这 样 的 情况 最 能 直接 反映 一 个 社会 、 组 织 或 部 门 当 中 机 制 的 运行 规律 。 在 任何 


好 的 机 制 可 以 使 一 个 社会 系统 接近 于 一 个 


机 制 的 构建 是 一 项 复杂 的 系统 工程 。 对 于 区 块 链 产品 而 言 ， 共 识 机 制 包含 各 种 激励 制度 和 


自 适 应 系统 (在 外 部 条 件 发 生 不 确定 变化 时 ， 能 


间 的 关系 以 更 好 地 发 挥 作用 的 具体 运行 方式 。” 


因为 工作 调整 ， 我 们 很 多 人 去 了 新 部 门 ， 之 后 大 家 


反映 ， 再 也 没有 了 当初 的 激情 ， 


一 个 系统 中 ， 机 制 都 起 着 基础 性 的 作用 ， 左 右 着 系统 的 发 展 和 走向 。 在 理想 状态 下 ， 良 


户 加 入 网 络 成 为 节点 呢 ? 又 有 哪些 激励 机 制 呢 ? 同时 ， 开 发 的 重点 是 让 多 个 节点 维护 一 个 数据 


F， 我 们 尝试 过 很 多 方法 ， 试 图 通过 某 种 激励 手段 提高 用 户籍 性 以 留 住 用 户 。 比 如 常见 的 积分 机 制 、 用 户 等 级 等 ， 
\ 社 会 ， 一 个 由 利益 驱动 的 自 适应 组 织 ， 这 个 组 织 的 


运行 需要 由 共识 机 制 来 规范 。 


制度 说 话 。 在 他 的 领导 下 ， 整 个 部 门 的 员工 都 富有 激情 、 心 无 旁 鸽 、 专 心 工作 ， 上 级 领导 也 非常 认可 ， 升 职 加 薪 
因为 工作 不 一 定 被 认可 ， 付 出 不 一 定 有 收获 。 


自动 地 迅速 做 出 正确 的 反应 ) 。 正 常 的 生物 机 体 (如 人 体 ) 就 具有 这 种 机 制 和 能 力 。 


具体 算法 ， 比 如 交易 费用 、 区 块 奖励 等 。 机 制 的 


观察 ， 看 看 人 参与 和 执行 的 积极 性 是 否 能 够 持续 。 如 果 不 能 持续 ， 那 么 就 预示 着 机 制 已 经 失败 ， 系 统 或 产品 也 将 消亡 。 


实际 上 ， 区 块 链 产品 的 目标 就 是 要 建立 一 个 “无 须 监管 的 自 适应 经 济 系统 ”。 有 目前 来 看 ， 支 撑 这 个 自 适应 经 济 系统 的 机 制 ， 常 用 的 有 三 种 


找到 对 应 的 经 济 模型 。 这 些 机 制 吸引 人 们 参与 其 中 ， 组 成 安全 


下 面 就 来 看 看 这 些 机 制 的 演进 过 程 。 


3.2 ”PoW: 工作 量 证 明 机 制 


1. 基 本 原理 


PoW (Proof of Work) 是 比特 币 采 上 


的 共识 机 制 ， 也 是 最 早 的 一 种 机 制 。 理 解 起 来 也 很 简单 ， 就 是 “ 按 劳 取 酬 ” 


里 ， 这 里 的 劳动 就 是 你 为 网 络 提供 的 计算 服务 ( 算 力 x 时 长 ) ， 提 供 这 种 服务 的 过 程 就 是 “ 挖 矿 ”。 


那么 “报酬 ”该 怎么 分 配 呢 ? 如 果 是 真 的 矿藏 ， 显 然 在 均匀 分 布 的 前 提 下 ， 人 们 “ 挖 矿 ” 所 得 的 “报酬 ”与 各 


2. 优 点 


机 制 本 身 当 然 很 复杂 ， 有 很 多 细节 ， 比 如 “ 挖 矿 ” 难 度 自动 调整 、 区 块 奖励 逐步 减 半 


理想 状态 下 ， 这 种 机 制 可 以 吸引 很 多 
与 “ 挖 矿 ”， 这 点 就 是 很 好 的 证 明 。 通 过 


3. 缺 点 


等 ， 这 些 


户 参与 其 中 ， 特 别 是 越 先 参与 的 ， 获 得 的 就 越 多 ， 会 促使 区 块 链 产品 的 初始 阶段 迅速 发 展 ， 节 点 网 


因素 都 是 基于 经 济 学 原理 设置 的 ， 以 吸引 和 


关键 因素 是 人 ， 评 判 一 个 机 制 的 好 坏 ， 往 往 要 通过 一 段 时 间 的 


， 它 们 分 别 是 PoW、PoS 和 DPoS， 而 且 它 们 都 能 在 现实 生活 中 


， 你 付出 多 少 劳动 (工作) ， 就 会 获得 多 少 报酬 (比特 币 等 加 密 货币 ) 。 在 网 络 世界 


自 提供 的 算 力 成 正比 ， 通 俗 一 点 说 就 是 ， 能 力 越 强 、 付 出 的 越 多 ， 获 得 的 就 越 多 。 


鼓励 更 多 的 人 参与 。 


络 迅 速 扩大 。 在 CPU 挖 矿 的 时 代 ， 比 特 币 吸引 了 很 多 人 参 


“ 控 矿 ”的 方式 发 行 新 币 ， 把 比特 币 分 散 给 个 人 ， 实 现 了 相对 意义 上 的 公平 ( 比 起 那些 不 用 挖 矿 ， 直 接 IPO 的 币 要 公平 得 多 ) 。 


1) 算 力 是 计算 机 硬件 (CPU、GPU 等 ) 提供 的 ， 需 要 耗费 电力 ， 是 对 能 源 的 直接 消耗 ， 与 人 类 追求 节能 、 清 洁 、 环 保 的 理念 相悖 。 不 过 


面 应 该 是 最 有 力 的 证 据 。 


， 如 果 非 


这 


区 块 链 产品 找寻 “货币 价值 ”的 意义 ， 那 么 这 方 


2) 这 种 机 制 发 展 到 今天 ， 算 力 的 提供 已 经 不 再 是 单纯 的 CPU 了 ， 而 是 逐步 发 展 到 GPU、FPGA 乃 至 AsIC 矿 机 。 用 户 也 从 个 人 挖 矿 发 展 到 大 的 矿 池 、 矿 场 ， 算 力 集中 越 来 越 明 显 。 这 与 去 中 心 化 的 方向 背 


道 而 驰 ， 渐 行 渐 远 ， 网 络 的 安全 也 逐渐 受到 威胁 。 有 证 据 证 明 ，Ghash (一 个 矿 池 ) 就 曾经 对 赌博 网 站 实施 了 双 花 攻击 ( 简 和 


地 说 就 是 一 笔 钱 花 两 次 ) 。 


3) 区 块 链 产品 区 块 奖 励 按照 一 定 的 周期 减 半 ， 当 “ 挖 矿 ” 的 成 本 高 于 挖 矿 的 收益 时 ， 人 们 “ 挖 矿 ” 的 积极 性 就 会 降低 ， 会 有 大 量 算 力 减少 ， 网 络 的 安全 性 也 将 进一步 降低 。 


3.3 ”PoS: 股权 证 明 机 制 


1. 基 本 原理 


PoS (Proof of Stake) 机 制 是 点 点 币 (PPC) 的 创新 。 没 有 “ 控 矿 ”过 程 ， 在 创 世 区 块 内 写 明 了 股权 分 配 比 例 ， 之 后 通过 转让 、 交 易 的 方式 (通常 就 是 PO) ， 逐 渐 分 散 到 用 户 手 里 ， 并 通过 “ 利 
息 ”的 方式 新 增 货币 ， 实 现 对 节点 的 奖励 。 


简单 来 说 ， 就 是 一 个 根据 用 户 持 有 货币 的 数量 和 时 间 ( 币 龄 ) ， 发 放 利息 的 一 个 制度 。 现 实 中 最 典型 的 例子 就 是 股票 或 者 是 银行 存款 。 如 果 用 户 想 要 获得 更 多 的 货币 ， 那 么 就 要 打开 客户 端 ， 让 它 保持 
在 线 ， 这 样 就 能 通过 “利息 ”来 获 益 ， 同 时 保证 网 络 的 安全 。 


2. 优 点 


1) 相对 节能 。 不 用 “ 挖 矿 ” ， 不 需要 大 量 消耗 电力 和 能 源 。 


2) 更 去 中 心 化 。 首 先 需要 说 明 的 是 ， 去 中 心 化 是 相对 的 。 相 对 于 比特 币 等 PoW 类 型 的 区 块 链 产品 ，PoSs 机 制 的 区 块 链 产 品 对 计算 机 硬件 基本 上 没有 过 高 的 要 求 ， 人 人 均 可 “ 挖 矿 ” (获得 利息 ) ， 不 上 
担心 算 力 集中 导致 中 心 化 的 出 现 〈 单 用 户 通过 购买 获得 51% 的 货币 量 ， 成 本 更 高 ) ， 网 络 更 加 安全 有 保障 。 


3) 避免 紧缩 。PoW 机 制 的 区 块 链 产品 ， 因 为 用 户 丢失 等 各 种 原因 ， 可 能 会 导致 通货 紧缩 ， 但 是 PoS 机 制 的 区 块 链 产品 按 一 定 的 年 利率 新 增 货币 ， 可 以 有 效 避 免 紧缩 的 出 现 ， 使 货币 保持 基本 稳定 。 比 特 
币 之 后 ， 很 多 新 币 也 采用 PoS 机 制 ， 很 多 之 前 采用 工作 量 证 明 机 制 的 旧 币 也 纷纷 修改 协议 ，“ 硬 分 又” 升级 为 Pos 机 制 。 


3. 缺 点 


纯 PoS 机 制 的 区 块 链 产 品 ， 只 能 通过 IPO 的 方式 发 行 ， 这 将 会 导致 “少数 人 ” (通常 是 开发 者 ) 获得 大 量 成 本 极 低 的 加 密 货币 ， 很 难保 证 他 们 不 会 大 量 抛售 。 因 此 ，PoSs 机 制 的 区 块 链 产品 ， 信 用 基础 不 
够 牢固 。 为 解决 这 个 问题 ， 很 多 区 块 链 产品 采用 PoW+ PoSs 的 双重 机 制 ， 通 过 PoW 机 制 “ 挖 矿 ” 发 行 ， 使 用 Pos 机 制 维护 网 络 稳定 。 或 者 采用 DPoS 机 制 ， 通 过 社区 选举 的 方式 增强 信任 。 


3.4 ”DPoS: 授权 股权 证 明 机 制 


1. 基 本 原理 


DPoS (Delegated Proof of Stake) 是 比特 股 (BTS) 最 先 引入 的 一 种 机 制 。 比 特 股 首次 提出 了 去 中 心 化 自治 公司 (DAC) 的 理念 。 比 特 股 的 目的 就 是 用 于 发 布 DAC。 这 些 无 人 控制 的 公司 发 行 股份 ， 
产生 利润 ， 并 将 利润 分 配给 股东 。 这 一 切 的 实现 ， 不 需要 信任 任何 人 ， 因 为 每 件 事 都 已 经 被 硬 编码 到 软件 中 了 。 通 俗 点 讲 就 是 ， 比 特 股 创造 可 以 盈利 的 公司 (股份 制 ) ， 股 东 持 有 这 些 公司 的 股份 ， 公 司 为 
股东 产生 回报 。 这 种 机 制 无 须 “ 挖 矿 ”。 


对 于 PoS 机 制 的 区 块 链 产品 ， 每 个 节点 都 可 以 创建 区 块 ， 并 按照 个 人 的 持 股 比例 获得 “利息 ”。DPoS 是 由 社区 中 选举 出 来 的 可 信 账 户 (受托 人 ， 得 票数 排行 前 101 位 ) 来 创建 区 块 的 。 为 了 成 为 正式 
托 人 ， 用 户 要 去 社区 拉票 ， 以 获得 足够 多 用 户 的 信任 。 用 户 根据 自己 持 有 的 加 密 货币 数量 占 总 量 的 百分比 来 投票 。DPoS 机 制 类 似 于 股份 制 公 司 ， 普 通 股 民 进 不 了 董事 会 ， 要 投票 选举 代表 (受托 人 ) 来 代替 
他 们 做 决策 。 


这 101 个 受托 人 可 以 理解 为 101 个 “ 矿 池 ”， 而 这 101 个 “ 矿 池 ”彼此 之 间 的 权利 是 完全 相等 的 。 那 些 握 着 加 密 货币 的 用 户 可 以 通过 投票 的 方式 随时 更 换 这 些 代表 (“ 矿 池 ”) ， 如 果 他 们 提供 的 算 力 不 
稳定 、 计 算 机 宕 机 ， 或 者 试图 利用 手中 的 权利 作恶 ， 那 么 他 们 将 会 立刻 被 用 户 们 踢 出 整个 系统 ， 而 后 备 代 表 则 可 以 随时 代 蔡 他 们 。 


2. 优 点 


1) 能 耗 更 低 。DPoS 机 制 将 节点 数量 进一步 减少 到 101 个 ， 在 保证 网 络 安全 的 前 提 下 ， 整 个 网 络 的 能 耗 将 进一步 降低 ， 网 络 运行 成 本 达到 最 低 。 


2) 更 加 去 中 心 化 。 目 前 ， 对 于 比特 币 而 言 ， 个 人 “ 挖 矿 ” 已 经 不 现实 了 ， 比 特 币 的 算 力 都 集中 在 几 个 大 的 “ 矿 池 ”手中 ， 每 个 “ 矿 池 ” 都 是 中 心 化 的 ， 就 像 DPoSs 的 一 个 受托 人 一 样 ， 因 此 DPos 机 制 
的 加 密 货 币 更 加 去 中 心 化 。Pos 机 制 的 区 块 链 产品 ， 要 求 用 户 客户 端 在 线 ， 事 实 上 用 户 并 不 会 每 天 都 开 着 电脑 ， 真 正 的 网 络 节点 是 由 几 个 股东 保持 的 ， 因 此 去 中 心 化 的 程度 也 不 能 与 DPos 机 制 的 区 块 链 产品 
相 比 。 


3) 更 快 的 确认 速度 。 比 如 ， 亿 书 使 用 DPoSs 机 制 ， 每 个 块 的 时 间 为 10 秒 ， 一 笔 交易 (在 得 到 6~10 个 确认 后 ) 大 概 1 分 钟 ， 一 个 完整 的 101 个 块 的 周期 大 概 只 需要 16 分 钟 。 而 比特 币 (PoW 机 制 ) 产生 一 
个 区 块 需要 10 分 钟 ， 一 笔 交易 完成 (6 个 区 块 确认 后 ) 需要 1 个 小 时 。 点 点 币 (Pos 机 制 ) 确认 一 笔 交易 大 概 也 需要 1 个 小 时 。 


2016 年 5 月 20 日 ， 比 特 股 的 作者 发 表 了 一 篇 文章 ( 见 3.7 节 ) ， 预 言 DAO (去 中 心 化 组 织 ) 和 DAC (去 中 心 化 公司 ) 都 将 失败 。 文 中 披露 了 大 量 的 实践 经 验 ， 基 本 上 都 是 DPoS 的 问题 ， 概 括 起 来 主要 如 


1) 投票 的 积极 性 并 不 高 。 绝 大 多 数 持 股 人 (90% 以 上 ) 从 未 参与 投票 。 这 是 因为 投票 需要 时 间 、 精 力 及 技能 ， 而 这 恰恰 是 大 多 数 投资 者 所 缺乏 的 。 


2) 对 于 坏 节 点 的 处 理 存在 诸多 困难 。 社 区 选举 不 能 及 时 有 效 地 阻止 一 些 破坏 节点 的 出 现 ， 这 一 点 对 网 络 造成 了 安全 隐患 。 


3.5” 亿 书 对 DPoS 机 制 的 改进 


不 过 ,不 可 否认 的 是 ，DPoS 机 制 仍然 是 目前 最 安全 环保 、 运 转 高 效 的 共识 机 制 。 存 在 的 问题 也 是 可 以 克服 和 解决 的 。 针 对 DPoS 的 问题 ， 亿 书 结合 自己 的 特点 ， 创 新 性 地 提出 了 如 下 4 点 改进 计划 。 


(1) 熔断 机 制 


增加 反对 投票 功能 ， 对 于 破坏 节点 的 反对 投票 率 如 果 达 到 了 一 定 的 数量 ， 就 会 触发 熔断 机 制 ， 强 制 个 别 受托 人 节点 降级 ， 以 减少 对 网 络 破坏 的 可 能 性 。 


(2) 信用 系统 


亿 书 鼓励 知识 分 享 ， 节 点 和 用 户 之 间 会 有 频繁 的 交互 ， 用 户 对 节点 的 反馈 与 好 评 ， 将 是 该 节点 信用 积累 的 一 部 分 。 亿 书 将 充分 利用 这 些 信用 信息 ， 帮 助 社区 用 户 送 选 优良 节点 。 


区 


(3) 扩大 规模 


0 


101 个 受托 人 ， 仅 仅 是 相对 合理 的 经 验 数字 。 亿 书 会 进一步 优化 算法 ， 提 高 网 络 送 选 的 性 能 ， 采 取 租 赁 、 出 售 等 方式 ， 鼓 励 去 中 心 化 应 用 的 开发 者 、 出 版 商 等 第 三 方 


Fs 


自 建 节点 ， 从 而 更 好 地 服务 于 


(4) 实名 认证 


匿名 与 安全 是 相对 平衡 的 过 程 。 亿 书 倡导 提供 公开 、 透 明 的 服务 ， 鼓 励 节 点 受托 人 进行 实名 认证 ， 公 开 相关 信息 ， 接 受 大 家 的 监督 ， 从 而 获得 社区 的 广泛 认可 。 对 于 长 期 表现 良好 的 节点 ， 亿 书 将 给 出 
名 单列 表 ， 并 显示 在 用 户 账号 里 。 


3.6 总 结 


/GAN= 口 


本 章 介绍 了 目前 区 块 链 产 品 普遍 采用 的 共识 机 制 ， 这 里 没有 介绍 瑞 波 币 采用 的 瑞 波 共 识 机 制 ， 因 为 从 严格 意义 上 来 说 ， 人 们 认为 瑞 波 币 不 是 去 中 心 化 的 ， 同 时 除了 瑞 波 币 自己 采用 瑞 波 机 制 之 外 ， 目 前 
还 没有 发 现 其 他 应 用 采用 该 机 制 ， 所 以 不 具备 普遍 性 ， 因 此 本 章 不 予 讨论 。 


实践 证 明 ， 设 计 良好 的 自 适应 系统 ， 必 须 拥有 完善 的 机 制作 为 支撑 ， 并 充分 考虑 人 的 因素 。 人 类 的 行为 是 复杂 的 ， 人 类 的 群体 行为 更 加 不 可 预测 ， 这 些 机 制 的 设计 最 初 都 是 良好 的 ， 但 谁 也 无 法 预料 在 
不 久 的 未 来 会 出 现 什么 状况 。 中 本 聪 当初 可 能 也 没有 想到 比特 币 会 变 成 今天 这 样 。 


从 技术 的 角度 来 讲 ， 共 识 机 制 的 核心 任务 就 是 解决 分 布 式 算法 中 著名 的 “拜占庭 将 军 问题 ”。 你 可 以 趁 热 打铁 ， 直 接 阅 读 第 三 部 分 的 第 17 章 ， 了 解 什么 是 “和 拜占庭 将 军 问 题 ”， 具 体 又 是 如 何 实 现 的 。 


3.7 参考 


《为 什么 PoSs 与 PoW 不 具有 可 比 性 》: http://zl.yibite.com/point/2014/0206/14440.shtml 


《 “去 中 心 化 的 比特 币 : 从 自 组 织 到 专业 化 分 工 ”读后感 》: http://www.8btc.com/PoW-bitcoin-upgrade 


《比特 股 创 始 人 : The DAO 在 走 BTS 的 老路 ， 或 离 死期 已 不 远 》: http://www.8btc.com/the-dao-going-to-be-doa 


《机 制 解析 》: http://wiki.mbalib.com/wiki/ 机 制 


第 4 章 ”区 块 链 架构 设计 


经 过 前 面 几 章 的 描述 ， 估 计 很 多 小 伙伴 都 想 赶快 学 点 具体 的 区 块 链 技术 ， 着 手 开发 一 款 真正 的 区 块 链 产品 了 。 但 是 ， 刚 刚 接 触 区 块 链 的 小 伙伴 可 能 会 感觉 非常 茫然 ， 无 从 下 手 。 所 以 ， 本 章 就 从 架构 设 
计 的 角度 谈 谈 区 块 链 的 技术 实现 ， 无 论 你 擅长 的 是 哪 一 种 编程 语言 ， 都 能 够 参考 这 种 设计 去 实现 一 款 区 块 链 产品 。 当 然 ， 具 体 到 产品 ， 架 构 设计 有 很 多 种 ， 不 同 的 人 、 不 同 的 产品 ， 架 构 设计 也 不 尽 相同 ， 
本 章 仅仅 提供 一 种 参考 ， 让 读者 能 够 直观 地 感受 区 块 链 的 技术 实现 ， 并 顺便 梳理 与 之 相关 的 知识 体系 ， 以 帮助 大 家 进一步 学 习 和 研究 。 


4.1 基本 概念 


区 块 链 是 加 密 货币 背后 的 技术 ， 目 前 它 已 经 成 为 与 VR、 人 工 智能 、 大 数据 等 比肩 的 热门 技术 之 一 。 什 么 是 区 块 链 技术 ? 为 了 让 大 家 对 这 个 问题 有 一 个 感性 的 认 知 ， 下 面 使 用 谷歌 地 球 的 例子 做 类 
比 ，Aax 虽 然 不 是 什么 新 技术 ， 但 是 与 其 他 技术 组 合 在 一 起 便 成 就 了 谷歌 地 球 。 与 之 类 似 的 ， 区 块 链 也 不 是 什么 新 技术 ， 但 其 与 加 密 解 密 技术 、P2P 网 络 等 组 合 在 一 起 ， 就 诞生 了 比特 币 。 很 多 技术 人 员 ， 
特别 是 Web 开 发 工程 师 ， 学 习 和 了 解 Ajax 技术 最 早 是 被 谷歌 地 球 酷 炫 的 效果 所 吸引 。 而 现在 ， 历 史 再 一 次 重演 ， 很 多 人 被 比特 币 的 迅猛 发 展 所 吸引 ， 进 而 开始 研究 其 背后 的 技术 一 一 区 块 链 。 


区 块 链 作为 比特 币 背 后 的 技术 ， 不 需要 中 心服 务 器 ， 即 可 实现 各 类 存储 数据 的 公开 、 透 明和 可 追溯 。 其 原本 是 比特 币 等 加 密 货 币 存 储 数 据 的 一 种 独特 方式 ， 是 一 种 自 引 用 的 数据 结构 ， 用 于 存储 大 量 的 
交易 信息 ， 每 条 记录 从 后 向 前 有 序 地 链接 起 来 ， 具 备 公开 透明 、 无 法 篡改 、 方 便 扎 溯 等 特点 。 实 际 上 ， 这 种 特性 也 直接 体现 了 整个 比特 币 的 特点 ， 因 此 使 用 区 块 链 来 概括 加 密 货 币 背后 的 技术 实现 是 非常 直 
观 和 恰当 的 。 区 块 链 是 一 项 技术 ， 加 密 货币 是 其 开发 实现 的 一 类 产品 (有 包含 代 币 ， 也 有 不 包含 代 币 的 区 块 链 产品 ) ， 不 能 等 同 或 混淆 。 与 加 密 货 币 相 比 ， 区 块 链 这 个 名 字 抛 开 了 代 币 的 概念 ， 更 加 形象 

化 、 技 术 化 、 去 政治 化 ， 更 适合 作为 一 门 技术 去 研究 和 推广 。 


所 以 ， 目 前 当 大 家 单独 提 到 区 块 链 的 时 候 ， 指 的 就 是 区 块 链 技 术 ， 是 实现 了 数据 公开 、 透 明 、 可 追溯 的 产品 的 架构 设计 方法 ， 这 时 算 作 广义 的 区 块 链 。 当 在 具体 的 产品 中 谈 到 区 块 链 的 时 候 ， 指 的 可 能 
是 类 似 于 比特 币 的 数据 存储 方式 ， 可 能 是 数据 库 设计 ， 还 可 能 是 文件 形式 的 设计 ， 这 时 算 作 狭 义 的 区 块 链 。 广 义 的 区 块 链 技术 必须 包含 点 对 点 的 网 络 设计 、 加 密 技术 应 用 、 分 布 式 算法 的 实现 和 数据 存储 技 
术 的 使 用 这 4 个 方面 ， 其 他 的 则 可 能 涉及 分 布 式 存储 、 机 器 学 习 、VR、 物 联网 、 大 数据 等 。 狭 义 的 区 块 链 仅仅 涉及 数据 存储 技术 、 数 据 库 或 文件 操作 等 。 本 章 所 提 到 的 区 块 链 指 的 是 广义 的 区 块 链 。 


4.2 架构 图 


从 架构 设计 上 来 说 ， 区 块 链 可 以 简单 地 分 为 三 个 层次 ， 即 协议 


、 扩 展 层 和 应 用 层 。 其 中 ， 协 议 层 又 可 以 分 为 存储 层 和 网 络 层 ， 它 们 相互 独立 但 又 不 可 分 割 ， 如 图 4-1 所 示 。 


4.3 协议 层 


协议 层 ， 指 的 是 最 底层 的 技术 。 这 个 层次 通常 是 一 个 完整 的 区 块 链 产品 ， 类 似 于 个 人 电脑 的 操作 系统 ， 它 维护 着 网 络 节点 ， 仪 提供 API 以 供 调用 。 通 常 ， 官 方 会 提供 简单 的 客户 端 (通称 为 钱包 ) ， 这 个 


客户 端 钱包 的 功能 也 很 简单 ， 只 能 建立 地 址 、 验 证 签名 、 转 账 支付 、 查 看 余额 等 。 这 个 层次 是 基础 ， 构 建 了 网 络 环境 、 搭 建 了 交易 通道 、 制 订 了 节点 奖励 规则 ， 至 于 你 要 交易 什么 ， 想 干什么 ， 它 一 概 不 过 
问 ， 也 过 问 不 了 。 典 型 的 例子 自然 是 比特 币 ， 还 有 各 种 二 代 币 ， 比 如 莱特 币 等 ， 本 书 所 介绍 的 亿 书 币 也 是 如 此 。 这 个 层次 ， 是 现 阶段 开发 者 聚集 的 地 方 ， 这 说 明 加 密 货 币 仍 处 于 起 步 阶段 。 


从 所 用 技术 的 层面 上 说 ， 协 议 层 主要 包括 网 络 编程 、 分 布 式 算法 、 密 码 学 和 数据 存储 技术 4 个 方面 ， 其 中 网 络 编程 能 力 是 大 家 选择 编程 语言 需要 主要 考虑 的 因素 ， 因 为 分 布 式 算法 基本 上 是 属于 业务 逻辑 
上 的 实现 ， 任 何 语言 都 可 以 做 得 到 ， 密 码 学 技术 属于 直接 简单 的 使 用 (参见 第 24 章 ， 不 建议 自由 发 挥 ， 没 有 过 多 的 编码 逻辑 ) ， 数 据 库 技 术 也 主要 属于 使 用 层面 ， 只 有 点 对 点 网 络 的 实现 和 并 发 处 理 才 是 开 
发 的 难点 ， 所 以 人 们 就 会 特别 偏爱 那些 网 络 编程 能 力 强 ， 同 时 并 发 处 理 简单 的 语言 。 也 正 因为 如 此 ，Nodejs 开 发 区 块 链 应 用 会 逐渐 变 得 更 加 流行 ，Go 语 言 也 在 逐渐 兴起 
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图 4-1 区 块 链 架构 设计 图 


司 4-1 所 示 的 架构 设计 图 将 这 个 层面 进一步 分 成 了 存储 层 和 网 络 层 。 数 据 存储 可 以 相对 独立 ， 选 择 的 自由 度 也 大 一 些 ， 可 以 单独 来 讨论 。 选 择 的 原则 无 非 是 性 能 和 易 用 性 。 我 们 知道 ， 系 统 的 整体 性 能 主 
要 取决 于 网 络 或 数据 存储 的 MO 性 能 ， 网 络 VO 优 化 的 空间 不 大 ， 但 是 本 地 数据 存储 的 MO 是 可 以 优化 的 。 比 如 ， 比 特 币 选择 的 是 谷歌 的 LevelDB， 据 说 这 个 数据 库 的 读 写 性 能 都 很 好 ， 但 是 很 多 功能 需要 开发 
者 自己 来 实现 。 目 前 ， 困 扰 业 界 的 一 个 重大 问题 是 ， 加 密 货币 的 交易 处 理 量 远 不 如 现在 中 心 化 的 支付 系统 (银行 等 ) ， 除 了 MO， 各 方面 都 需要 进行 全 方位 的 突破 。 


在 实现 点 对 点 网 络 的 过 程 中 需要 使 用 分 布 式 算法 、 加 密 签名 等 ， 所 以 它们 自然 都 是 网 络 层 的 事情 ， 也 是 编码 的 重点 和 难点 ， 本 书 分 享 的 基本 上 就 是 这 部 分 的 内 容 。 当 然 ， 也 有 把 点 对 点 网 络 的 实现 单独 
分 开 的 ， 将 节点 查找 、 数 据 传输 和 验证 等 逻辑 独立 出 来 ， 而 将 共识 算法 、 加 密 签名 、 数 据 存储 等 操作 放 在 一 起 组 成 核心 层 。 无 论 怎么 组 合 ， 这 两 个 部 分 都 是 最 核心 、 最 底层 的 部 分 ， 都 是 协议 层 的 内 容 。 
4.4 扩展 层 


这 个 层面 类 似 于 电脑 的 驱动 程序 ， 是 为 了 让 区 块 链 产品 更 加 实用 。 目 前 有 两 类 扩展 层 : 一 是 各 类 交易 市 场 ， 是 法 币 兑换 加 密 货币 的 重要 渠道 ， 实 现 简单 、 来 钱 快 、 成 本 低 ， 但 风险 也 大 ; 二 是 针对 某 个 
方向 的 扩展 实现 ， 例 如 基于 亿 书 侧 链 ， 可 为 第 三 方 出 版 机 构 、 论 坛 网 站 等 内 容 生产 商 提供 定制 服务 等 的 扩展 实现 。 在 此 ， 特 别 值得 一 提 的 是 ， 大 家 听 得 最 多 的 “智能 合约 ”， 就 是 典型 的 扩展 层面 的 应 用 开 
发 。 所 谓 “ 智 能 合约 ”， 就 是 “可 编程 合约 ”， 或 者 称 为 “合约 智能 化 ”， 其 中 的 “智能 ”是 执行 上 的 智能 ， 也 就 是 说 ， 当 达到 | 某 个 条 件 时 ,合约 就 会 自动 执行 ， 比 如 自动 转移 证 券 、 自 动 付 款 等 ， 目 前 还 
没有 比较 成 型 的 产品 ， 但 不 可 否认 的 是 ， 这 将 是 区 块 链 技术 的 重要 发 展 方向 。 


扩展 层 使 用 的 技术 基本 上 没有 什么 限制 ， 包 括 很 多 ， 例 如 上 面 提 到 的 分 布 式 存储 、 机 器 学 习 、VR、 物 联网 、 大 数据 ， 等 等 。 在 编程 语言 的 选择 上 ， 可 以 更 加 自由 ， 因 为 可 以 与 协议 层 完全 分 离 ， 编 程 语 
言 也 可 以 不 同 于 协议 层 使 用 的 开发 语言 。 在 开发 上 ， 除 了 在 交易 时 与 协议 层 进行 交互 之 外 ， 其 他 时 候 尽量 不 要 与 协议 层 的 开发 混在 一 起 。 这 个 层面 与 应 用 层 更 加 接近 ， 也 可 以 理解 为 B/S 架 构 的 产品 中 的 服务 
器 端 (Server) 。 这 样 不 仅 可 以 在 架构 设计 上 更 加 科学 ， 让 区 块 链 数据 更 小 ， 网 络 更 独立 ， 同 时 也 可 以 保证 扩展 层 的 开发 不 受 约束 。 


从 这 个 层面 来 看 ， 区 块 链 可 以 架构 开发 任何 类 型 的 产品 ， 不 仅仅 是 应 用 于 金融 行业 。 在 未 来 ， 随 着 底层 协议 的 更 加 完善 ， 任 何 需要 第 三 方 支付 的 产品 都 可 以 方便 地 使 用 区 块 链 技术 ;任何 需要 确 权 、 征 
信和 追溯 的 信息 ， 都 可 以 借助 区 块 链 来 实现 。 笔 者 个 人 觉得 ， 这 个 目标 应 该 很 快 就 能 实现 。 


4.5 ”应 用 层 


这 个 层面 类 似 于 电脑 中 的 各 种 软件 程序 ， 是 普通 人 真正 可 以 直接 使 用 的 产品 ， 也 可 以 理解 为 B/S 架 构 的 产品 中 的 浏览 器 端 (Browser) 。 这 个 层面 的 应 用 ， 目 前 几乎 是 一 片 空 白 。 市 场 强 待 出 现 这 样 的 应 
引爆 市 场 ， 形 成 真正 的 扩张 之 势 ， 让 区 块 链 技术 快速 走 进 寻 常 百姓 家 ， 以 服务 于 大 众 。 大 家 所 使 用 的 各 类 轻 钱包 (客户 端 ， 应 该 算 作 应 用 层 最 简单 、 最 典型 的 应 用 。 很 快 ， 亿 书 将 基于 亿 书 网 络 推出 文 
档 协 作 工具 ， 这 个 就 是 典型 的 应 用 层 的 产品 。 


限于 当前 区 块 链 技术 的 发 展 ， 亿 书 只 能 从 协议 层 出 发 ， 把 目标 指向 应 用 层 ， 同 时 为 第 三 方 开发 者 提供 扩展 层 的 强大 支持 。 这 样 做 既 可 以 避免 仿 多 ， 又 可 以 避免 无 法 落地 ， 是 真正 理性 的 开发 路 线 。 因 为 
纯粹 地 开发 协议 层 或 扩展 层 ， 是 无 法 真正 理解 和 验证 应 用 层 的 ， 会 脱离 实际 ， 使 得 第 三 方 开发 者 很 难 使 用 。 如 果 仅 仪 考虑 应 用 层 ， 市 面 上 又 找 不 到 真正 牢固 易 用 的 协议 层 或 扩展 层 的 产品 。 所 以 ， 我 们 只 好 
全 面 发 力 ， 采 取 完 全 开源 开放 的 态度 ， 通 过 社区 的 力量 ， 共 同 去 做 一 件 有 意义 的 事情 ， 也 算 为 国内 区 块 链 技术 的 发 展 做 一 些 技术 积累 和 微薄 贡献 。 


4.6 ”编程 实现 


很 多 小 伙伴 习惯 于 结合 自己 的 技术 背景 来 理解 上 面 的 架构 设计 。 下 面 将 结合 具体 的 编程 语言 简单 介绍 几 款 产 品 ， 以 供 参考 。 


TC/C++ 


这 两 个 语言 是 无 法 逾越 的 ， 任 何 开发 如 果 遇 到 | 瓶颈， 基本 上 都 会 找到 它们 ， 自 然 应 该 排 在 第 一 位 来 介绍 。 同 时 ， 区 块 链 技术 的 鼻祖 ， 比 特 币 (协议 层 ) 就 是 用 C++ 语 言 开发 的 ， 而 且 到 目前 为 止 , 没有 
比比 特 币 更 加 成 功 的 区 块 链 产品 了 。 所 以 ， 无 论 你 使 用 什么 语言 进行 开发 ， 在 正式 进入 这 个 行业 之 前 ， 都 应 该 先 研究 一 下 比特 币 。 比 特 币 官方 客户 端 钱包 使 用 的 是 Qt， 第 三 方 钱 包 有 Python 语言 开发 的 ， 特 
别 是 第 三 方 整理 的 开发 库 (API 包 ) 很 多 都 是 Node.js 设 计 的 。 比 特 币 的 架构 与 上 面 的 架构 设计 基本 相同 ， 另 外 ， 因 为 共识 算法 采用 的 是 工作 量 证 明 机 制 (Proof of Work，PoW) ， 因 此 还 有 一 些 特殊 
的 “ 挖 矿 ”的 过 程 。 其 他 竞争 币 都 是 直接 来 自 于 比特 币 的 分 支 ， 所 以 编程 语言 是 相同 的 ， 具 体 的 技术 选 型 和 技术 实现 上 可 能 会 有 所 改进 ， 比 如 : 莱特 币 使 用 了 其 他 的 加 密 算法 。 


官方 网 站 : https://bitcoin.org/ 


源码 库 : https://github.com/bitcoin 


2.Node.js/JavaScript 


Nodejs 平 台 拥 有 强大 的 网 络 编程 能 力 ， 再 加 上 JavaScript 脚 本 语言 简单 快捷 ， 因 此 在 区 块 链 领 域 自然 少不了 它们 的 身影 。 亿 书 便 是 这 样 一 个 区 块 链 产 品 ， 亿 书 币 是 它 的 协议 层 ， 使 用 了 著名 的 Express 
开发 框架 ， 基 于 HTTP 开 发 而 成 。 同 时 ， 它 采用 了 授权 股权 证 明 机 制 (DPoS) ， 算 法 上 的 改进 让 它 在 处 理 交易 时 更 加 轻 量 ， 处 理 能 力 得 到 大 大 提升 。 同 时 ， 它 提供 了 强大 的 协作 机 制 ， 为 数字 出 版 、 版 权 保 
护 提供 了 便利 ; 它 扩 展 了 侧 链 功能 ， 可 以 基于 它 开发 任何 去 中 心 化 的 应 用 ， 从 而 为 专业 作者 、 博 客 爱好 者 和 开发 者 提供 了 很 多 方便 。 本 书 将 完整 分 享 亿 书 的 源码 ， 从 区 块 链 基础 概念 到 代码 实现 ， 从 基本 原 
理 到 开发 设计 思路 ， 都 将 进行 比较 详细 的 探索 。 截 至 目前 ， 从 协议 层面 深入 代码 讲解 区 块 链 技术 实现 的 图 书 极 少 ， 本 书 算 作 一 本 。 


官方 网 站 : http://ebookchain.org/ 


源码 库 : https://github.com/Ebookcoin 


3.Python 


如 果 您 是 Python 语言 爱好 者 ， 那 么 建议 研究 一 下 以 太 坊 (Ethereum) 的 Python 实现 。 尽 管 以 太 坊 因 为 “The Dao 事件” 六 得 沸沸扬扬 ， 但 从 技术 实现 的 角度 来 说 ， 其 仍然 值得 参考 学 习 。 以 太 坊 官方 
定位 为 一 种 开发 管理 分 布 式 应 用 的 平台 ， 主 攻 方 向 就 是 “智能 合约 ”， 并 为 其 定制 了 一 种 编程 语言 Solidity。 以 太 坊 的 核心 是 以 太 坊 虚 拟 机 (EVM) ， 人 允许 用 户 按照 自己 的 意愿 创建 操作 。 以 太 坊 给 出 了 
Go、Java、Python 等 多 种 语言 的 实现 。 其 中 以 Python 为 基础 的 实现 主要 包括 三 个 部 分 : Pyethapp 是 客户 端 部 分 ; Pyethereum 是 核心 库 ， 实 现 了 区 块 链 、 以 太 坊 模 拟 机 和 “ 控 矿 ”等 功能 ; Pydevp2p 是 
点 对 点 网 络 库 ， 实 现 了 节点 发 现 、 合 约 代码 传输 、 加 密 签名 等 功能 。 这 三 者 组 合 在 一 起 就 是 完整 的 区 块 链 实现 ， 后 面 两 个 核心 库 共同 组 成 了 协议 层 。 另 外 ，go-ethereum 是 Go 语言 的 完整 实现 ; 

Ethereum (J) 是 纯 Java 实 现 ， 它 可 以 嵌入 任何 Java/Scala 项 目 。 客 户 端 方面 还 有 Rust、Ruby、Javascript 等 语言 的 实现 。 


官方 网 站 : https://ethereum.org/ 


源码 库 : https://github.com/ethereum/pyethapp 


4.Go 


在 多 核 时 代 ，Go 语 言 备 受 喜 爱 ， 它 可 以 让 你 用 同步 的 方式 轻松 实现 高 并 发 ， 特 别 是 在 分 布 式 系统 、 网 络 编程 等 领域 ， 其 应 用 非常 广泛 。 所 以 ， 在 区 块 链 开发 领域 ， 也 有 很 多 使 用 Go 语言 开发 的 项 目 。 
其 中 ， 由 Linux 基 金 会 主导 的 超级 账本 (HyperLeger) ， 版 本 库 的 名 字 为 Fabric 的 就 是 其 中 一 个 。 该 项 目 试图 为 新 一 代 的 事务 应 用 创建 一 种 开放 的 分 布 式 账本 标准 ， 支 持 许可 式 区 块 链 (这 种 方式 可 能 无 法 
再 现 比 特 币 那 种 强大 的 网 络 效应 ) 。Fabric 的 开发 环境 建立 在 VirtualBox 虚 拟 机 上 ， 部 署 环境 可 以 自 建 网 络 ， 也 可 以 直接 部 署 在 BlueMix 上 ， 部 署 方式 可 docker 化 ， 支 持 用 Go 和 JavaScript 开 发 智能 合约 。 
它 采用 的 是 PBFT 分 布 式 算法 ， 网 络 编程 方面 采用 的 是 gRPC 来 做 P2P 通 信 ， 使 用 Protocol Buffer 来 序列 化 要 传递 的 数据 结构 。 在 架构 设计 上 ，Fabric 可 能 与 比特 币 等 区 块 链 产品 有 所 不 同 ， 但 上 述 的 基本 组 
成 部 分 还 是 不 可 或 缺 的 。 


出 


官方 网 站 : https://www.hyperledger.org/ 


源码 库 : https://github.com/hyperledger 


其 他 编程 语言 ， 比 如 C# 等 ， 也 有 具体 实例 ， 这 里 就 不 再 列举 了 。 总 之 ， 针 对 不 同 的 编程 语言 ， 在 具体 的 编码 或 架构 设计 上 可 能 会 有 所 差别 ， 其 差别 甚至 会 很 大 ， 但 是 协议 层 所 使 用 的 技术 并 没有 太 大 的 
变化 。 其 中 ， 网 络 编程 是 重点 和 难点 ， 多 数 没有 现成 的 框架 可 用 ， 都 是 使 用 编程 语言 自身 提供 的 库 来 进行 设计 开发 ， 所 以 比较 底层 ， 非 常 考验 开发 者 的 编码 功底 。 


4.7 ”知识 图 谱 


根据 上 面 的 分 析 ， 我 们 已 经 可 以 了 解 区 块 链 是 什么 ， 并 知道 怎么 实现 了 ， 下 面 就 来 梳理 一 下 其 中 的 编程 技术 知识 ， 自 然 就 会 清晰 得 多 了 。 区 块 链 技术 知识 图 谱 如 图 4-2 所 示 。 
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图 4-2 ”区 块 链 技术 知识 图 谱 


根据 个 人 的 理解 ， 笔 者 把 与 区 块 链 相关 的 知识 分 成 了 5 个 部 分 ， 具 体 如 下 。 


1. 基 础 知识 


区 块 链 是 新 技术 ， 与 之 相关 的 是 其 背后 大 量 的 新 概念 、 新 理论 。 这 些 知识 虽然 不 直接 体现 在 编码 里 ， 却 是 理解 区 块 链 、 掌 握 区 块 链 技术 的 基础 知识 ， 所 以 理 当 成 为 区 块 链 技术 不 可 或 缺 的 一 部 分 。 这 则 
分 从 基本 概念 入 手 ， 到 工作 原理 的 描述 ， 基 本 能 够 将 区 块 链 的 基础 知识 全 部 覆盖 。 学 习 区 块 链 开发 技术 ， 首 先 要 学 习 掌握 这 部 分 内 容 。 


2. 技 术 实现 


区 块 链 是 一 项 技术 ， 但 从 上 面 的 分 析 可 以 看 出 ， 它 应 该 是 一 种 架构 应 用 ， 架 构 的 实现 理 当 是 区 块 链 技术 实现 的 核心 。 正 如 大 家 所 看 到 的 ， 任 何 一 款 区 块 链 产 品 ， 协 议 层 必须 包括 点 对 点 网 络 、 密 码 学 、 
数据 存储 和 分 布 式 算法 4 个 部 分 ， 应 用 层 也 必然 要 提供 钱包 、 客 户 端 浏览 器 等 基础 应 用 。 


对 于 扩展 层 部 分 ， 区 块 链 技术 可 以 对 接 各 种 应 用 ， 比 如 金融 、 物 联网 、 网 络 安全 、 版 权 保护 、 电 子 商务 ， 等 等 ， 现 有 的 很 多 技术 都 可 以 用 在 这 里 。 只 不 过 ， 如 何 与 区 块 链 结合 ， 如 何 实现 跨行 业 使 
自然 是 这 部 分 内 容 研究 的 课题 。 所 以 ， 多 研究 和 学 习 几 款 这 样 的 开源 产品 ， 对 提高 自己 的 编码 能 力 是 很 有 帮助 的 。 


3. 开 发 环境 


区 块 链 是 多 项 技术 的 组 合 ， 有 其 自身 的 复杂 性 ， 个 别 应 用 对 开发 环境 的 依赖 较 大 ， 开 发 工具 与 环境 搭建 是 让 开发 者 快速 上 手 的 重要 内 容 。 


4. 项 目 实践 


据说 ， 短 短 数 年 ， 全 球 区 块 链 产品 已 经 达到 了 几 千 个 ， 其 中 不 乏 创 新 应 用 。 很 多 优秀 的 开源 产品 和 项 目 实践 就 是 最 好 的 学 习 研 究 资料 。 


5. 开 发 文档 


这 个 自然 就 不 用 多 说 了 ， 每 一 种 产品 都 会 有 自己 的 开发 文档 。 此 外 ， 它 是 有 心 的 开发 者 整理 汇总 的 一 些 资源 ， 可 以 帮助 他 们 节省 很 多 查询 的 时 间 。 


在 考虑 这 个 知识 体系 的 过 程 中 ， 笔 者 主要 思考 的 是 ， 读 者 循 着 这 些 标 签 去 查阅 文章 ， 能 否 快 速 掌 握 区 块 链 技术 ， 并 最 终 上 手 开 发 实现 一 个 区 块 链 产品 。 另 外 ， 笔 者 也 刻意 规避 了 与 具 


体 编程 语言 以 及 特 


定 领域 相关 的 词汇 ， 唯 一 可 以 区 分 的 就 是 这 些 节 点 之 下 对 应 的 文章 标签 。 所 以 ， 这 些 分 类 就 显得 非常 中 性 。 笔 者 也 曾 考虑 过 使 用 比特 币 、 竞 争 币 、 智 能 合约 、 数 字 资 产 、 智 能 资产 等 具体 领域 的 实现 作为 分 


类 方法 ， 但 又 怕 限 制 了 读者 的 思维 ， 另 外 ， 随 着 区 块 链 的 发 展 ， 新 概念 必然 层出不穷 ， 若 按照 具体 的 实现 进行 分 类 ， 这 个 图 谱 就 需要 不 停 地 修改 下 去 。 


4.8 ”总结 


/GAN= 口 


本 章 描述 了 区 块 链 技术 的 基础 架构 ， 需 要 再 次 强调 的 是 ， 这 只 是 一 种 实现 方式 ， 并 非 所 有 的 区 块 链 产品 都 是 如 此 ， 我 们 也 期 待 着 出 现 更 多 的 创新 ， 也 相信 一 定 会 出 现 。 本 章 的 编程 实现 部 分 ， 罗 列 了 几 
种 编程 语言 及 其 实现 的 典型 产品 ， 因 为 协议 层 技 术 较为 底层 ， 并 没有 太 多 现成 的 框架 需要 介绍 或 讨论 ， 同 时 ， 具 体 的 技术 细节 也 绝 非 几 行 字 就 能 够 罗列 清楚 的 ， 所 幸 这 些 产品 都 是 开源 产品 ， 大 家 可 以 结合 


自己 的 技术 背景 ， 进 一 步 查看 对 应 的 产品 源码 ， 很 快 就 能 了 解 其 中 的 奥妙 。 


术 


众 


区 ,始终 走 在 技术 前 沿 ， 该 文 最 先 被 CSDN 发 布 在 主页 头条 位 置 ， 后 来 被 巴 比 特 论坛 等 多 家 网 络 媒体 转载 。 


4.9 参考 


CSDN 发 布 的 地 址 : http://geek.csdn.net/news/detail/106765 


CSDN 区 块 链 知 识 库 : http://lib.csdn.net/base/blockchain 


eg es 
二 部 分 Node.js 入 门 指南 
这 部 分 的 内 容 主要 是 针对 初学 者 。 如 果 您 是 Node.js 高 手 ， 那 么 可 以 直接 跳 过 。 


任何 一 门 技术 都 有 一 定 的 门槛 ，Node.js 也 不 例外 。 这 部 分 将 以 解决 技术 选 型 为 切入 点 ， 从 开发 一 个 统计 分 析 工 具 入 手 ， 带 着 问题 逐步 深入 展开 。 


如 果 你 是 一 位 初学 者 ， 那 么 其 中 大 量 的 知识 需要 你 自己 去 补充 。 因 为 这 部 分 章节 的 目标 不 在 Node.js 本 身 ， 并 且 笔 者 个 人 的 时 间 和 水 平 也 有 限 ， 在 必要 的 地 方 ， 只 能 做 一 些 简单 提示 。 


第 5 章 ”Nodejs 在 币 圈 流行 么 


本 章 主要 讲解 技术 选 型 、 币 圈 开 源 项 目 使 用 的 开发 语言 现状 ， 以 及 被 程序 员 广 泛 参 与 的 前 10 个 比特 币 相关 的 开源 项 目 。 


开发 一 个 产品 之 前 ， 我 们 总 会 纠结 应 该 选择 使 用 什么 样 的 技术 。 技 术 的 选择 需要 考虑 几 个 素 ， 其 中 包括 自身 所 掌握 的 技能 、 项 目 兼容 性 、 软 硬件 环境 ， 以 及 应 用 场景 等 。 


不 管 怎样 ， 选 择 一 种 通用 的 语言 平台 往往 是 相对 合适 的 。 这 样 做 可 以 学 习 更 多 的 案例 ， 获 得 更 多 的 社区 支持 ， 同 时 还 能 大 大 降低 技术 风险 。 


我 们 计划 使 用 Nodejs 开 发 区 块 链 应 用 ， 这 个 选择 是 否 可 行 ? 下 面 就 尽 可 能 地 从 各 个 方面 考察 一 下 。 


5.1 ”Nodejs 在 开源 社区 很 流行 


在 开源 社区 ，Github 大 名 昂昂 ， 下 面 先 来 看 看 在 其 上 托管 的 项 目 语言 的 使 用 情况 。 


Github 官 方 每 年 都 会 对 托管 在 其 平台 上 的 项 目 情况 进行 统计 分 析 ， 下 面 是 2016 年 最 新 的 统计 数据 ( 见 《2016 年 Github 官 方 报告 》) 。 


从 图 5-1 中 可 以 看 出 ， 在 整个 开源 社区 ，JavaScript 应 用 得 最 为 广泛 。 如 果 你 点 开 其 中 的 链接 ， 仔 细 审 查 ， 会 发 现 它们 都 是 建立 在 Node.js 平 台 之 上 的 ， 哪 怕 纯 前 端的 项 目 也 是 如 此 。 


也 提醒 了 我 们 ， 目 前 JavaScript 语 言 所 对 应 的 大 部 分 项 目 都 是 基于 Node.js 平 台 的 ， 也 就 是 说 ， 对 于 成 熟 的 项 目 ，JavaScript 语 言 大 致 可 以 代表 Node.js。 


降 


项 便 说 一 下 ， 本 章 是 应 CSDN 知 识 库 专家 组 邀请 ， 为 发 起 并 筹建 区 块 链 知识 库 而 写 的 推荐 文章 ， 目 的 是 帮助 更 多 的 程序 员 小 伙伴 通俗 感性 地 认识 和 了 解 区 块 链 ， 权 当 抛砖引玉 。CSDN 作 为 国 


内 著名 的 技 


15 most Popular languages used on GitHub by opened Pull Request and 
Percentage change from previous period 


1,684,1319 


[a 


和 


忆 甲 辐 


0 375K 750K 1.5M 


Standouts include JavaScript. C#, and Go Who have seen almost doubled growth Swift and 
Type Script are up and coming with 3.5x growth. 


图 5-1 2016 年 Github 上 15 个 最 流行 的 编程 语言 


5.2 ”Nodejs 在 币 圈 也 同样 流行 


5.2.1 ”Github 自 带 搜索 


可 以 使 用 Github 自 带 的 搜索 工具 ， 在 搜索 框 内 输入 如 下 的 内 容 : 


bitcoin stars:>100 forks:>50 


结果 如 图 5-2 所 示 。 


Search bitcoin stars:>100 forks:>50 | a 


We've found 73 repository results Sort Best match ~ | 


局 Repositories 


《> Code 
bitcoin/bitcoin C++ 码 8,188 5,562 


Bitcoin Core integration/staging tree 


全 lssues 


鸟 Users 


Updated 4 hours ago 


Languages 


Python 


Javascript bitcoinj/bitcoinj Java 广 627 ?539 


人 A library for working with Bitcoin 


C++ 

Ruby 

PHP 

Cc 
Objective-C 
HTML 

css 


Updated 12 hours ago 


schildbach/bitcoin-wallet Java 方 514 1?516 


Bitcoin Wallet app for your Android device. Standalone Bitcoin node, no 
centralized backend required. 


Updated 6 days ago | 
i 有 _ 名 网 | NE 二 


Advanced search Cheat sheet etotheipi/BitcoinArmory C++ 坎 483 P237 


图 5-2 ”与 bitcoin 相 关 ，star 超 过 100，fotk 超 过 50 的 搜索 结果 


可 以 使 用 更 加 复杂 的 查询 条 件 进行 搜索 ， 比 如 : 


bitcoin OR wallet stars:>100 forks:>50 in:file extension:md 


上 述 代码 表示 在 文件 扩展 名 为 .md 的 文件 中 ， 查 询 包 含 关键 字 bitcoin 或 wallet，star 超 过 100，fork 超 过 50 的 全 部 项 目 库 。 


其 他 情况 请 自己 试验 。 


5.2.2 ”自制 查询 工具 


程序 员 天 生 就 是 “ 懒 人 ”， 为了“ 一劳永逸 ”地 获得 想 要 的 结果 ， 笔 者 专门 为 本 章 配 套 设计 了 一 个 小 工具 ， 下 面 就 来 看 看 它 的 效果 吧 。 


上 面 两 个 查询 的 对 应 结果 用 柱状 图 和 树 形 矩阵 图 表示 如 下 。 


1 .柱状 图 


网 


查询 bitcoin 关 键 字 ， 可 获得 如 图 5-3 所 示 的 柱状 图 。 
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This is a goo0d example. 
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图 5-3 与 bitcoin 相 关 ，fo 水 排行 前 100 的 项 目 柱 状 图 


查询 wallet 关 键 字 (不 一 定 是 加 密 货币 钱包 ) ， 可 获得 如 图 5-4 所 示 的 柱状 图 。 


Top100 BarChart 


This is a good example. 
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图 5-4 ”与 wallet 相 关 ，fo 水 排行 前 100 的 项 目 柱状 


2. 树 形 和 矩阵 图 


查询 bitcoin 关 键 字 ， 可 获得 如 图 5-5 所 示 的 矩阵 | 


哆 


dwallet 414 


liabloMiner <50 


lalectrum 593 


可 以 使 


图 5-5 与 bitcoin 相 关 fo 红 排行 前 100 的 项 目 树 形 矩 阵 图 


Github 的 搜索 功能 ， 并 选择 forks 数 量 倒序 排列 查看 Github 上 的 应 用 ， 查 询 语句 如 下 : 


bitcoin language:JavaScript 


GS; FE 蕊 ”每 一 个 fo 水 背后 可 能 就 是 一 个 全 新 的 产品 ，forks 代 表 了 程序 被 二 次 开发 的 情况 ， 个 人 觉得 对 于 技术 选 型 来 说 ，forks 相 对 更 有 说 服 力 。 


前 10 个 应 用 具体 如 下 。 


(1) bitpay/bitcore 1656 颗 星 ，429 个 分 支 


源码 网 址 : httr 


第 一 位 ， 


该 应 用 是 bitpay 团 队 的 产品 ， 号 称 下 一 代 PayPal。 该 应 上 


(2) startup-class/bitstarter-leaderboard 295 颗 星 ，386 个 分 支 


源码 网 址 : https/ 


om/startup-class/bitstarte 


第 二 位 ， 


该 应 用 是 一 个 基于 比特 币 开发 众 筹 网 站 的 模板 程序 。 很 多 人 也 想 进 入 这 个 领域 ， 大 家 可 以 参考 学 习 。 


(3) bitcoinjs/bitcoinjs-lib ”980 颗 星 ，305 个 分 支 


源码 网 址 : h 


第 三 位 ， 


该 应 用 是 一 个 比特 币 Web 钱 包 开发 包 ， 当 前 市 面 上 几乎 所 有 基于 网 站 的 钱包 都 在 使 有 


(4) askmike/gekko 866 颗 星 ，300 个 分 支 


源码 网 址 : https://github.com/askmik 


第 四 位 ， 


该 应 用 是 一 个 链接 几 大 交易 市 场 的 比特 币 交易 机 器 人 。 它 支持 多 种 交易 策略 ， 可 以 监测 实时 的 交易 市 场 ， 使 


下 它 的 处 理 逻 辑 ， 或 许 还 能 获得 某 些 启发 。 


(5) bitpay/insight-ui 354 颗 星 ，267 个 分 支 


源码 网 址 : https://github.com/bitpay/ 


第 五 位 ， 


该 应 用 是 bitpay 放 出 的 一 个 开发 Web 钱 包 的 Ul 包 (要 基 


(6) kyledrake/coinpunk ”733 颗 星 ，249 个 分 支 


该 应 用 。 


算是 一 个 成 功 案例 ， 足 见 Nodejs 开 发 加 密 货币 的 可 行 性 。 


自动 交易 方法 进行 现场 或 模拟 交易 。 如 果 你 也 想 推出 一 个 交易 网 站 ， 那 么 研究 一 


Fbitcoin-node 开 发 ) ， 看 来 当前 开发 钱包 的 需求 还 是 比较 大 的 。 该 应 用 可 以 与 排行 第 七 位 的 bitpay/insight-api 配 合 开发 。 


第 六 位 ， 该 项 目 是 一 个 本 地 化 的 钱包 服务 程序 ， 已 经 停止 维护 ， 取 而 代 之 的 是 排名 第 3 位 的 bitcoinjs-lib。 
(7) bitpay/insight-api 

略 。 

(8) db/GitTorrent 3065 颗 星 ，133 个 分 支 


源码 网 址 : https://github.com/db/GitTorrent 


第 八 位 ， 不 过 它 的 好 评 (3065 颗 星 ) 是 最 高 的 。 这 是 一 个 去 中 心 化 的 Github， 该 应 
产品 开发 扩展 了 视野 。 基 于 这 个 项 目的 思路 ， 可 以 设想 很 多 有 价值 的 应 用 。 


(9) bitcoinjs/bitcoinjs-server 

源码 网 址 : https://github.com/bitcoinjs/bitcoinjs-server 

第 九 位， 已 经 停止 维护 。 

(10) untitled-dice/untitled-dice.github.io 26 颗 星 ，114 个 分 支 


源码 网 址 : https://github.com/untitled-dice/untitled-dice.github.io 


第 十 位 , 该 应 


是 一 个 基于 比特 币 的 赌博 网 站 源码 。 有 意思 的 是 ， 


其 实 ， 还 有 很 多 应 


没有 开源 或 者 处 于 半 开 源 状态 ， 


因此 被 关注 得 不 多 ， 鲜 为 人 知 。 


5.4 结论 


根据 上 述 数据 分 析 ， 我 们 可 以 得 出 如 下 结论 : 
“ 在 整个 开源 社区 ，Node.js 是 当之无愧 的 、 最 流行 的 开发 平台 之 一 。 
在 钱包 、 交 易 市 场 等 客户 端 应 用 领域 ，Node.js 的 应 用 较为 广泛 。 


“ 在 加 密 货币 核心 代码 的 开发 上 ，Node.js 的 应 用 较 少 ， 远 不 如 Python、Java、C、C++ 等 开发 语言 的 使 用 率 。 


不 过 ， 由 于 JavaScript 


5.5 总 结 


本 章 的 数据 收集 面 仍然 比较 狭 窗 ， 无 法 完整 呈现 币 圈 全 貌 ， 所 列 的 数据 仅 供 参 考 之 


本 章 只 是 一 篇 软文 ， 写 作出 来 并 不 难 ， 真 正 的 工作 量 在 于 数据 统计 分 析 ， 而 这 一 点 也 


想 知道 本 章 的 数据 和 图 表 是 怎么 来 的 吗 ” 请 看 第 6 章 。 第 6 章 将 简单 介绍 Nodejs 的 基本 使 


5.6 参考 


《2016 年 Github 官 方 报告 》: https://octoverse.github.com/ 


第 6 章 ”Node.jsi 上 前 端 开发 像 子弹 飞 一 样 


的 作者 写 了 一 篇 博客 ， 详 细 解 释 了 为 什么 Git 也 要 去 中 心 化 。 笔 者 个 人 觉得 ， 该 项 目 确实 很 有 意思 ， 


评价 (26 颗 星 ) ， 很 低 ， 但 是 复制 的 分 支 却 很 多 ， 对 于 开发 者 来 说 ， 这 也 算是 比特 币 的 一 个 落地 应 用 。 


户 群众 多 ， 随 着 加 密 货币 的 发 展 和 普及 ， 会 有 更 多 的 Node.js 开 发 者 加 入 。 选 择 Node.js， 就 像 最 初 选择 了 bitcoin 一 样 ， 作 为 第 一 批 实践 的 


。 如 果 后 续 发 现 更 多 更 好 的 应 
为 Nodejs 而 变 得 轻松 愉快 。 


、 数 据 挖 握 和 统计 分 析 的 技巧 ， 并 阐释 那些 交易 市 场 、 在 线 钱包 等 实时 应 


为 去 中 心 化 的 


户 ， 我 们 已 经 站 在 了 时 代 的 潮 头 。 


， 笔 者 会 持续 修改 更 新 ， 读 者 可 以 关注 本 章 的 电子 版 。 


的 开发 过 程 。 


从 本 章 开 始 ， 我 们 将 正式 进入 Nodejs 的 世界 。 本 章 主要 指引 你 搭建 Nodejs 开 发 环境 ， 介 绍 Nodejjs 的 安装 、 使 
新 的 认 知 ， 还 将 学 习 到 如 何 将 一 些 第 三 方 平 台 的 资源 收 为 己 用 。 


方法 ， 以 帮 你 快速 了 解 Nodejs。 通 过 本 章 的 学 习 ， 你 将 对 前 端 开 发 有 一 个 完整 的 、 全 


本 章 所 列举 的 实例 就 是 第 5 章 所 提 到 的 加 密 货币 开发 语言 统计 分 析 项 目 (Statistical Analysis of Cryptocurrency Development Languages，SACDL) ， 在 线 体验 地 址 为 http:Wimfly.github.io/sacdl- 


project/。 


6.1 项 目 需求 


SACDL 项 目 需要 具备 以 下 几 个 功能 。 


“能够 方便 地 读 取 第 三 方 网 站 (这 里 是 Github) 的 API， 实 现 项 目 搜索 功能 。 


“能够 对 读 取 的 数据 进行 集中 处 理 ， 将 其 方便 地 转化 为 我 们 所 需要 的 信息 。 


“能够 通过 柱状 区 


、 矩 阵 图 、 


表格 等 图 表格 式 ， 将 数据 可 视 化 。 


“ 方便 扩展 ， 为 后 续 添加 更 多 


6.2 


无 处 不 选择 。 不 仅 大 方向 需要 选择 ， 具 体 到 每 个 开发 包 也 要 去 仔细 甄别 ， 判 断 它们 安全 吗 ? 好 
仅 从 上 述 需求 来 说 ， 一 个 HTML 文 件 再 加 一 个 JavaScript 文 件 基本 上 就 可 


但 


技术 选 型 


Node.js 的 优点 具体 如 下 。 


: 组 织 方便 : JavaScript 没 有 模块 化 组 织 代码 的 能 力 。 在 一 个 项 目 中 ，JavaScript 代 码 通常 会 被 分 


以 让 你 轻松 组 织 代码 。 


有 实 上 ， 很 多 项 目 就 算 只 是 前 端的 项 目 ， 比 如 Bootstrap 等 ， 也 都 是 基 


表 样 式 或 其 他 网 站 API (比如 交易 市 场 的 ) 做 好 准备 。 


FNode.js 的 ， 


为 什么 ? 答案 很 简单 ， 


荐 到 不 同 的 文件 


吗 ? 性 能 高 吗 ? 是 否 有 更 好 的 解决 方案 ? .……… 


以 满足 需求 了 ， 一 般 来 说 是 不 需要 第 三 方 包 的 ，Node.js 更 是 大 材 小 用 。 


因为 Node.js 提 供 了 很 多 方便 又 实用 的 工具 。 


“ 资源 广泛 : Node.js 的 出 现 让 JavaScript 第 三 方 包 像 雨 后 春 荔 一 样 遍地 开花 。 如 果 需 要 什么 ， 只 要 一 条 命令 ，Node.js 就 能 帮 您 办 理 了 ， 这 一 点 带 来 了 极 大 的 便利 。 


PP， 如 果 采 用 以 往 的 方式 ， 处 理 起 来 将 会 非常 头疼 ， 现 在 利用 Node.js 的 模块 进行 管理 ， 可 


“ 全 栈 处 理 : 开发 完 后 还 有 很 多 事情 要 做 ， 比 如 ， 要 对 前 端 代 码 JavaScript 或 CSS 文 件 进行 合并 、 压 缩 、 混 淆 ， 以 及 项 目 部 署 等 。 体 验 过 Ruby on Rails 一 键 部 署 功能 的 小 伙伴 ， 都 会 对 其 印象 深刻 。Node.js 


也 很 容 


易 就 能 做 到 这 点 ， 而 且 更 加 自然 、 流 畅 。 


总 之 ， 有 了 Nodejs， 我 们 就 可 以 像 开发 后 台 程序 一 样 组 织 前 端 代码 和 项 目 了 ; 有 了 Nodejs， 就 可 以 利用 它 背 后 强大 的 技术 社区 支持 。 


6.3 


有 读者 说 ， 第 一 次 看 到 Node.js， 还 以 为 就 是 一 个 JavaScript 文 件 呢 。 其 实 这 很 正常 ， 很 多 前 端的 应 


Nodejs 简 介 


JavaScript 文 件 。 那 么 ，Node.js 是 什么 呢 ? 


官方 解释 是 这 样 的 : 


Node.js ®is aJavaScript runtime built on Chrome”s V8 JavaSctript engine.Node.js uses an event-dtiven, non-blocking I/O model that makes it lightweight and eff|icient. 


翻译 如 下 : 


Node.js 国 是 一 个 搭建 在 Chrome V8 上 的 JavaScript 即 时 运行 平台 ， 采 用 的 是 事件 驱动 和 非 阻塞 1/O 模 型 ， 既 轻 量 又 高 效 。 


通俗 的 解释 就 是 ，Node.js 是 一 个 可 以 让 您 利 


:二 > 
月 


请 注意 ， 这 里 所 说 的 并 不 只 是 Web 应 用 ， 很 多 人 认为 Nodejs 公 能 


JavaScript 语 言 开 发 应 


的 平台 ， 


是 构建 运行 在 分 布 式 设备 上 的 数据 密集 型 实时 程序 的 完美 选择 。 


PHP+Apache、JSP+Tomcat、Ruby on Rails+Passenger (或 Thin) +Nginx 等 传统 Web 开 发 的 绝 佳 蔡 代 品 。 


如 果 你 对 此 还 没有 直观 的 感受 ， 那 么 我 告诉 你 一 个 信息 ，Nodejs 的 
的 每 一 个 应 用 ， 既 可 以 看 作 一 个 服务 器 软件 ， 也 可 以 看 作 一 个 Web 应 | 


作者 原本 就 是 想 开发 一 种 


,向 


什么 是 数据 密集 型 、 实 时 的 应 用 ? 


聊天 室 、 即 时 通信 等 都 是 数据 密集 型 、 实 时 的 应 
笔者 刚 完成 的 一 个 项 目 ， 一 家 大 型 连锁 超 


6.4 


开发 步骤 


下 


面 所 要 介绍 的 开发 过 程 可 能 会 有 点 烦琐 ， 读 者 需要 耐心 点 ， 其 实 实践 步 


6.4.1 


搭建 环境 


对 于 初学 者 ， 建 议 先 去 Node.js 官 方 网 站 浏览 一 遍 。 


笔者 个 人 的 开发 环境 具体 如 下 ， 在 此 列 出 仅 供 参考 。 


“ 操作 系统 是 Ubuntu 系统 : 您 可 以 在 现 有 的 系统 上 ， 使 用 虚拟 机 软件 安装 Ubuntu 系统 。 我 们 的 全 部 示例 和 截 区 


“IDE 工 具 : Sublime Text 或 Atom。 


。 当 然 ， 还 包括 交易 市 
的 电器 设备 综合 监控 系统 ， 就 是 使 


它 还 如 此 简单 、 高 效 。 


场 (比特 币 、 股 票 、 基 金 等 ) ， 电 子 商 务 网 站 的 即时 交易 等 ， 甚 至 物 联 网 ， 比 如 电器 设备 的 监控 和 远程 控制 等 也 是 此 类 应 用 。 
Node.js 开 发 的 。 


强烈 建议 参考 Node.js 的 官网 信息 (Node.js 官 方 网 站 的 地 址 请 参见 6.6 节 ) 。 


可 在 Ubuntu 上 通过 nvm 安 装 和 管理 Node.js， 


人 遍 。 下 面 是 笔者 个 人 的 安装 习惯 ,摘录 其 中 的 关键 命令 (各 条 命令 都 要 在 Ubuntu 的 命令 行 


安装 Nvm 


程序 下 运行 ) 分 别 如 下 。 


$ curl -o- https:// raw.githubusercontent .com/creationix/nvm/v0.29.0/install.sh | bash 


Nvm 安 装 Node.js 


发 以 服务 器 为 中 心 的 Web 应 用 ， 其 实 不 然 ， 它 还 可 以 开发 PC 端 或 移动 端的 应 


汉代 Apache、Nginx、Tomcat 等 产品 的 传统 服务 器 软件 的 ， 结 果 发 展 成 了 今天 的 Node.js， 你 F 


都 是 在 Ubuntu 系统 上 完成 的 。 


。 当 然 ， 我 们 看 到 的 大 部 分 都 是 Web 应 用 ， 


， 比 如 大 家 讨论 最 多 的 前 端 开发 框架 三 剑客 一 一 Angular.js、Backone.js 和 Ember.js 就 是 一 个 


它 是 


Node.js 写 


体 方法 可 参见 《快速 搭建 Node.js 开 发 环境 及 加 速 npm》 (文档 网 址 : https://cnodejs.org/topic/5338c5db7cbade005b023c98) ， 请 务必 阅读 一 


$ nvm install 5.1.0 
$ nvm alias default 5.1.0 


说 明 : 5.1.0 是 Nodejs 的 版 本 信息 ， 写 作 本 章 时 ，Node.js 的 最 新 稳定 版 是 5.4.0， 长 期 支持 版 是 4.2.4。 
安装 使 用 CNpm 


使 用 淘宝 npm 镜 像 (http://npm.taobao.org/) ， 可 以 提高 国内 组 件 的 下 载 数 度 : 


$ npm install -g cnpm --registry=https:// registry.npm.taobao.org 


查看 版 本 信息 


$ nvm -v 
$ node -v 
$ npm -v 


笔者 的 版 本 信息 如 下 : 


nvm 0.29.0 
node v5.1.0 
npm v3.3.12 


6.4.2 新建 工 程 


在 电脑 上 ， 新 建 一 个 文件 夹 sacdl-project， 以 此 作为 工程 目录 ， 路 径 如 下 : 


/home/yourname/projects/sacdl-project 


我 们 通常 会 把 前 端 代码 放 在 public 目 录 下 ， 然 后 分 别 建立 js、css、images 等 目录 ， 最 后 建立 文件 index.html 和 js/appjs， 分 别 用 于 显示 页 面 和 编写 JavaScript 代 码 。SACDL 工 程 目录 结构 如 图 6-1 所 示 。 


~/projects/doing/sacdl-project /public/index.html (sacdl-project) - Sublime Text 


<meta name="viewport" conten 
<title> 加 密 货币 开发 语言 统计 分 析 
<I-- build:css ./css/app.min.css --> 
10 <link type="text/css" rel="styleshe 
11 <link type="text/css" rel="styleshe 
12 <link type="text/css" rel="styleshe 
13 <!-- /build --> 
14 </head> 
15 | 
16 <body> 
7 <nayv class="navbar navbar-defau 
18 <div class="container-fluid"> 


19 <!|-- Brand and togegle get gro 


20 <div class= "navbar-header > 
21 <button type="button" cla 
navbar-collapse-1" aria-ex 

22 <span class="sr-only">To 
23 <span class="icon-bar">1 
24 <span class="icon-bar">1 
25 <span class="icon-bar”">* 
26 </button> 

"27 <a class="navbar-brand" h 
28 </div> 
29 <!-- Collect the nav links, fo 
30 <div class="collapse navbar-d 
31 </div> 
32 <!I-- /.navbar-collapse -> 
33 </div> 


图 6-1 SACDL 工 程 目录 结构 


到 6-1 所 示 的 目录 结构 中 ，bower_components 文 件 夹 用 于 存放 前 端 第 三 方 组件 ， 比 如 D3.js 等 ， 由 bower 自 动 生成 ; node_modules 文 件 夹 用 于 存放 后 台 第 三 方 模块 ， 由 npm 自 动 生成 。Dist 文 件 夹 
于 存放 需要 合并 处 理 的 目标 文件 ， 使 用 gulp 维 护 。test 位 于 测试 文件 夹 下 ， 存 放 测试 代码 。public 文 件 夹 用 于 存放 我 们 自己 编写 的 代码 ， 其 中 各 项 文件 具体 如 下 。 


“js/searcher.js: 表示 搜索 框 处 理 代 码 。 
“js/utils.js: 表示 数据 处 理 代码 。 


- js/barjs: 表示 文件 是 D3.js 的 柱状 图 代码 。 


“js/treemap.js: 表示 文件 是 矩阵 图 的 代码 。 


“js/app.js: 表示 用 户 综合 调用 ， 类 似 于 控制 器 或 路 由 。 


6.4.3 ”前 端 组 件 


在 命令 行 中 ， 进 入 上 述 工程 目录 ， 安 装 前 端 管理 工具 bower: 


$ cnpm install -g bower # 也 可 以 使 用 npm install * 命令 ， 二 者 一 样 ， 只 不 过 cnpm 使 用 淘宝 镜像 ， 在 国内 安装 cnpm 下 载 会 更 快 些 


@i bower 是 一 个 hpm 包 ， 专 门 用 于 管理 Web 前 端 (包含 js、css、images、fonts 等 ) 依赖 包 的 。 我 们 可 以 进行 简单 类 比 ，bower 用 于 管理 前 端 包 ，npm 用 于 管理 后 台 库 ( 包 ) ， 二 者 的 用 法 十 分 相似 。 


初始 化 bower， 代 码 如 下 : 


$ bower init 


结果 如 图 6-2 所 示 。 


kuby@kuby-virtual-machine:~/proijects/doing/sacdl-proijects$ bower init 
? name sacdl-project 

? description 加 富 货 币 开 点 语言 统计 分 析 ，Statistical Analysis of Cryptocurrency 日 
nt Languages 

main file index, js 

what types of moduLes does this package expose? 

keywords Crvptocurrency ,bitcotn ,d3js,nodejs 

authors imfly 

license NIT 

homepage https:;//github.com/imfly/sacdl-project 

set currently installed components as dependencies? Yes 

add commonly ignored files to ignore list? Yes 

Would you like to mark this package as private which prevents -tt from being ac 
clidentally published to the registry? “es 


{ 

name: 'sacdl-project', 

description: 加 密 货 市 开发 诸 言 统计 分 术 ， Statistical Analysis of Cryptocurrency 
DeweLcpment Languages 

main: "index, js' ， 

authors: [ 


显示 桌面 
ltcense: ‘NIT', 
keywords: [ 
Cryptocurrency ， 
'bitcoin’', 
SS 
‘nogde]s 
]， 
homepage: 'https://github.com/imfly/sacdl-projsct', 
moduleType: [1], 
private: 上 truec ， 
ignore: [ 
‘ae. 
'node_ modutes， - 
'bower_componentts 
‘test 
'tests， 


] 
} 


7 Looks good? (Y/rn) 上 国 


图 6-2 bower 初始 人 
这 样 就 会 生成 一 个 bowerjson 文 件 ， 然 后 ， 代 码 就 可 以 被 当 作 一 个 完整 的 前 端 组 件 来 管理 了 。 


通过 bower 安 装 D3js， 代 码 如 下 : 


$ bower install d3 --save 


命令 加 上 选项 --save， 将 在 bowerjson 文 件 里 写 入 如 


这 样 ， 在 另 一 台电 脑 上 进行 开发 时 ， 复 制 完 代码 (git clone) ， 就 可 以 直接 运行 下 面 的 命令 ， 自 动 安装 所 有 要 依赖 的 第 三 方 组 件 了 : 


$ bower intall 


侠 说 明 D3.js 可 提供 前 端 显示 的 柱状 图 、 饼 状 图 等 ， 是 非常 著名 的 数据 可 视 化 前 端 开发 包 。 国 内 的 数据 可 视 化 软件 有 百度 的 echarts ， 还 有 一 个 highcharts， 这 三 者 经 常 被 拿 来 做 比较 。 对 这 三 者 的 简单 区 
分 就 是 ，D3.js 像 开发 包 ， 可 以 任意 编程 开发 ， 但 据说 入 门 较 难 ; 其 他 两 个 更 像 是 模板 ， 拿 来 就 可 以 直接 使 用 。 


笔者 选择 的 是 D3js， 这 样 选 择 纯 属 个 人 喜好 : 一 方面 ， 笔 者 个 人 喜欢 完全 控制 代码 ; 另 一 方面 ， 在 开发 电子 书 版 权 保护 和 交易 系统 时 会 用 到 它 。 


6.4.4 “前端 流程 


按照 上 面 所 述 的 需求 ， 前 端的 流程 大 致 如 图 6-3 所 示 。 


Top100 BarChart 


This is a good example, 


cH BO Projects -om 
- HE] 
Tava EY 
rython EE 
Hm 图 
css 图 


图 6-3 SACDL 的 前 端 处 理 流程 


图 6-3 中 的 流程 编号 具体 解释 如 下 。 


1) 接收 请 求 : 提供 一 个 输入 框 ， 接 收 用 户 输入 ， 获 得 查询 关键 字 ， 并 转化 为 github.com 的 API 请 求 地 址 。 


2) 获得 数据 : 根据 上 述 地 址 ， 通 过 Ajax 请 求 数据 (这 里 是 D3.js 的 D3json () 方法 ) ， 对 数据 进行 处 理 。 


3) 展示 数据 : 使 用 D3js 编 写 图 表 样式 ， 然 后 将 上 述 数 据 展示 出 来 。 


6.4.5 ”学 习 API 


第 一 步 非常 简单 ， 只 需要 提供 一 个 输入 框 就 可 以 了 。 我 们 直接 从 第 二 步 开始 研究 。 


Github 是 用 Ruby on Rails 开 发 的 ， 它 的 API 具 有 典型 的 RESTful API 风 格 。 下 面 将 展示 官方 的 搜索 示例 (https://developer.github.com/v3/search/) 。 


请 求 下 面 的 地 址 : 


https:// api.github.com/search/repositories?q=tetristlanguage:assembly&sort=stars&order=desc 


可 以 得 到 对 应 的 JSON 格 式 的 数据 。 官 方 使 用 的 是 curl 命 令 行 工具 ,我们 直接 使 用 浏览 器 即 可 ， 如 图 6-4 所 示 。 


{ 
“total_count”: 340, 
"incomplete_results": false, 
“items": [ 
{ 
“id": 21095601, 
“name": “Tetris-Duel”, 
“full name": “Tetris-Duel-Team/ Tetris-Duel”, 
“owmer”: { 
“login”: “Tetris-Duel-Teanm’, 
“id": 7956696, 
“avatar_url”: "https://avatars. githubusercontent. com/W/ T956696?v=3", 
“gravatar_id“: “", 
“url": “https://api, github, com/ users/ Tetris-Duel-Team’, 
“html_ur1l" : “https://github. com/ Tetris-Duel-Team”, 
“followers url": “https://api. github. comusers/Tetris-Duel-Team/followers", 
“following_url": “https://api. github. com/users/Tetris-Duel-Team/following {/other_user}”, 
“gists url’: “https://api. github. com/users/Tetris-Duel-Team gists{/gist_id}”, 
“starred ur]”: “https://api. github. com/users/Tetris-Duel-Team starred{/owmer} {/repo}, 
“subscriptions url”: “https://api. github. com/users/Tetris-Duel-Team subscriptions ， 
"organizations_url”: "https://api. github. com/users/Tetris-Duel-Team/ orgs”, 
“repos_url”: "https://api. github. com/users/Tetris-Duel-Team/ repos”, 
“events_url”: "https://api, github. comusers/Tetris-Duel-Team/ events{/privacy}", 
“received events url”: "https://api. github. com/users/Tetris-Duel-Team received events”, 
“type": “Organization”, 
“site_admin": false 


} 


的 


3 

private”: false, 

“html_ur1l": "https://github. com/ Tetris-Duel-Team/ Tetris-Duel”, 

“description": “NWultiplayer Tetris for Raspberry Pi (in bare metal assembly)", 
“fork”: false, 

“url”: “https://api. github, com/ repos/ Tetris-Duel-Team/ Tetris-Duel”, 


图 6-4 浏览 器 下 请 求 Github 搜 索 API 的 结果 


图 6-4 就 是 我 们 得 到 的 原始 数据 结构 。 大 部 分 情况 下 ， 需 要 对 其 进行 重新 整理 ， 不 然 就 不 用 费劲 去 开发 了 。 下 面 ， 我 们 先 把 它 转 化 为 树 形 矩 阵 图 所 需要 的 数据 格式 ， 代 码 如 下 : 


{ 
"name": "languages", 
"children": [{ 
"name": "javascript", 
"children": [{ 
"name": "imfly/myIDE", 
"watchers_count": 100, 
"forks count": 50 
Hl 
}] 
} 


上 述 代码 的 意思 是 ， 整 个 数据 的 根 节点 就 是 languages (自己 建立 即 可 ) ， 它 以 各 个 语言 为 子 节点 ; 各 语言 则 以 它们 的 版 本 库 为 子 节 点 ， 这 里 存储 的 才 是 我 们 需要 的 基本 信息 。 


6.4.6 ”数据 整理 


在 public/js 文 件 夹 下 ， 先 新 建 utilsjs (名 字 随 便 起 ) ， 然 后 使 用 文本 编辑 器 打开 ， 笔 者 在 此 使 用 的 是 Sublime text。 


1 .模块 化 前 端 代码 


为 了 实现 模块 化 编程 ， 可 采用 如 下 的 格式 组 织 前 端 代码 (当然 ， 这 并 不 是 Nodejs 的 模块 形式 ， 不 过 效果 异曲同工 ) : 


var Utils = (function(){ 
// 局 部 变量 定义 


var a= 0; 


// 公共 方法 
retarn { 

settings: function(){}, 

init: function(){}, 

http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
} 


// 私有 方法 
function name(){} 


}10) 


在 引入 该 文件 的 index.html 文 件 里 ， 可 以 像 如 下 代码 这 样 进行 调用 : 


Utils.init (): 


而 无 法 这 样 调 用 : 


Utils .name ():; 


2. 转 换 数 据 格式 


如 何 将 API 读 取 的 数据 整理 成 我 们 想 要 的 格式 呢 ? 代码 如 下 : 


// 一 定 会 有 一 个 地 方 可 用 来 传 入 dataset， 先 别 着 急 
function getTreeData (dataSet) 1{ 
Var languages = {}; 


// 新 建 根 节点 

Var result = { 
"name": "languages", 
"chilgdren": [] 


// 循环 处 理子 节点 


if (dataSet && 
var items = 


qdataSet .items) { 
dataSet .items; 


// 先 找 出 涉及 语言 


items .forEalk 
if (typ 


这 
}) 


ch (function (item, index) { 
eof languages[item.language] === "undefined. 
languages [item.language] = index; 


// 根据 语言 进行 整理 


for (var language in Languages) 


// 有 些 版 本 库 ， 
if (language === 


是 没有 语言 信息 的 。 六 thub 的 语言 识 别 并 不 是 完美 的 
ll) { 


language = "others" 


}; 


// 每 种 语言 的 子 节点 


Var root = 
"name": 


{ 
language, 


"children": [] 


] 7 


// 从 全 局 数据 中 再 次 查找 我 们 的 数据 
items.forEach (function (item, index) { 
var child= { 


item.full name, 


"watchers_count": item.watchers count, 
"forks_count": item.forks count 


这 


") 1{ 


if (item.language =—= language || (item.language === "null"&& language 


=—= "others")) { 


root.children.push (child) 7 


] 7 
DD 


result.children.push (root); 


} 
// 返回 结果 


return result; 


显然 ， 这 是 一 个 私有 方法 。 因 为 类 似 这 样 对 数据 进行 的 整理 ， 每 一 个 轿 


请 参考 源码 js/utilsjs。 


6.4.7 ”D3js 演 染 


现在 已 经 获得 了 数据 ， 


1. 了 解 D3.js 流 程 


有 人 说 ， 对 于 初学 者 ， 


接 下 来 就 是 将 数据 变 成 我 们 想 要 的 样式 了 。 


表 都 要 做 。 先 把 上 面 的 方法 作为 第 一 步 处 理 ， 然 后 再 将 结果 缓存 起 来 ， 其 他 格式 的 数据 都 以 它 为 基础 来 获得 (公共 方法 ) ， 具 体 


D3js 的 入 门 有 点 困难 。 如 果 你 在 尝试 了 之 后 ， 确 实 觉得 很 困难 ， 可 以 选择 ECharts 或 xXCharts (来 自 于 D3.js，6.6 节 中 有 链接 ) ， 方 法 相同 。 


D3js 的 基本 流程 如 下 。 


1) 在 HTML 中 ， 提 供 


2) 请 求 并 填充 数据 。 


展示 图 表 的 位 置 ， 通 常 是 提供 一 个 div#ld。 


3) 泻 染 图 表 ， 用 append () 新 增 元 素 ， 用 remove () 删除 多 余 的 元 素 。 


下 面 用 最 简单 的 例子 来 演示 一 下 (代码 在 工程 源码 的 test 文 件 夹 下 ) 。 


在 test.html| 页 面 添 加 一 个 div 元 素 ， 代 码 如 下 : 


<div id="testId"></div> 


新 建 testjs 文 件 ， 代 码 


如 下 : 


// 下 面 是 要 演 染 的 数据 ， 
Var dataset = [1, 2, 


可 以 动态 获得 
3 4]s 


// 填充 数据 ， 通 常 要 使 用 d3.1layout 提 供 的 数据 模板 进行 处 理 ， 然 后 用 data() 方 法 去 填充 
var chart = d3. select ('#testId') 


.SelectAll('p 


全 


to (Gale function(d) { return qd; }); 


// 泻 染 视图 ， 主 要 采用 下 面 的 两 个 方法 
// data() 之 后 才 可 以 调用 的 enter () 方 法 ， 意 思 是 有 数据 填充 的 那 部 分 图 表 元 素 ， 通 常 要 附加 ('append' ) 元 素 


chart 
.enter () 
.append ('p') 


.text (ESE on ta 2 


return [d, i]; 


}) 


// data() 之 后 才 可 以 调用 的 exit () 方 法 ， 意 思 是 无 法 获得 数据 填充 的 那 部 分 图 表 元 素 ， 通 常 要 删除 ('remove' ) 元 素 


Chart .exit () .remove( 


) 7 


比如 上 面 的 代码 ， 默 认 提 供 了 dataset 的 4 个 数值 ， 第 一 次 渲染 


， 会 正常 显示 4 个 元 素 ; 接着 ,数据 dataset 换 成 [5，6] ， 再 次 演 染 ，enter () 方法 将 获得 原来 泻 染 [1，2] 的 元 素 ， 并 将 其 值 蔡 换 成 


[5, 6] ,而 [3, 4] 位 


的 元 素 因 为 没有 了 数据 而 被 删除 ， 这 样 就 实现 了 


图 表 的 动态 转换 。 


多 注意 上 面 提 到 的 d3.layout 可 能 是 一 个 凑 履 性 的 概念 。layout 作 为 层 的 概念 ， 通 常 在 HTML 视 图 中 用 作 全 局 共享 的 模板 文件 ， 比 如 : layout.html、layout.ejs 等 。 但 是 ， 这 里 D3.js 是 用 在 数据 上 的 ， 提 供 了 
d3.layout.treemap () 等 方法 ， 用 于 对 各 种 图 表 数 据 进行 计算 和 处 理 ， 即 数据 


方法 ， 实 现 页 面 控制 的 。 


2 . 泻 染 我 们 的 数据 


显然 ， 这 样 做 的 意义 就 是 真正 的 数据 驱动 。 


模板 。D3.js 的 视图 处 理 ， 就 是 使 用 append () 和 tremove () 去 增加 或 删除 元 素来 进行 处 理 ， 配 合 诸如 .style () 元 素 样式 格式 化 的 


D3js 提 供 了 D3.json、d3.csv() 等 请 求 数据 的 方法 ， 上 述 的 数据 是 JSON 格 式 ， 自 然 就 采用 前 者 了 。 


我 们 以 矩阵 图 


为 例 (这 里 也 是 参考 的 官方 示例 ， 见 6.6 节 ) ， 在 index.html 中 加 入 如 下 元 素 : 


<div id="sacdlTreemap"></div> 


然后 ,编写 js/treemap.js 代 码 ， 用 于 泻 染 图 表 。 


最 后 ， 在 js/appjs 里 加 载 数据 ， 代 码 如 下 : 


一 -部 分 代码 ------ 
D3.json (url, function(err, data) { 
if (err) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


alert ("加 载 数 据 失 败 ， 请 检查 您 的 网 络 设置 。") 


ls 


Utils.getData (data):; 


Treemap. show (); 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


了 部 分 代 三- 
具体 请 看 源码 。 
3. 查 看 效果 
因为 前 端 不 用 服务 器 ， 因 此 直接 右键 选择 “在 浏览 器 中 打开 ” 即 可 。 下 面 来 看 看 效果 如 何 ， 如 图 6-5 所 示 。 


加 密 货 币 开 发 语言 统计 分 析 , Statistical Analysis of Cryptocurrency Development Languages - Mozilla Firefox 
加 密 货币 开发 语言 统计 ..， x 


Search for... 


6.4.8 ”代码 调试 


图 6-5 浏览 器 请 求 静态 文件 并 查看 效果 


如 果 达 不 到 预期 效果 ， 那 么 如 何 发 现 问题 所 在 呢 ? 前 端 调 试 和 测试 也 是 一 门 学 问 ， 篇 幅 所 限 ， 在 此 无 法 细 说 ， 请 读者 自行 查阅 相关 资料 。 笔 者 个 人 常用 的 调试 前 端 代码 的 工具 ， 就 是 火狐 浏览 器 的 
firebug 扩 展 插 件 。 当 然 ， 对 于 该 应 用 ， 用 火狐 或 谷歌 浏览 器 默认 的 控制 台 就 可 以 了 。 


具体 用 法 是 ， 在 打开 的 浏览 器 页 面 中 ， 按 下 F12， 在 页 面 的 底部 就 会 弹出 控制 台 窗口 了 ， 如 图 6-6 所 示 。 


回 - 回回 | 浆 0ox 
[aid 机 出 | 


a mutating the [[Prototype]] of an object will cause your code to run very slowly; tnstead create the object with the correct initial [[Prototypej] value using Object.create d3.min.js:3:10398 
A ”所 用 的 getPreventDefault() 已 不 赞成 使 用 。 请 使 用 defaultPrevented 蔡 代 。 


https//apigithub.com/search/repositories?g =wallet&sort=forks&order=desca&per _page=100 
GET EEE httpsyaplgithubcom/seardrepositorles 


图 6-6 使 用 火狐 浏览 器 的 控制 台 调 试 


从 图 6-6 中 可 以 看 出 ,错误 信息 、 断 点 信息 等 一 目 了 然 。 


6.4.9 ”部 署 发 布 


经 过 一 番 调 试 ， 代 码 终于 达到 了 预期 的 效果 。 为 了 提高 页 面 的 加 载 速度 ， 增 强 用 户 体验 ， 还 需要 对 代码 进行 合并 、 压 缩 。 如 果 想 要 保护 自己 的 劳动 成 果 ， 不 想 被 别人 无 偿 使 用 ， 那 么 还 需要 对 代码 进行 
混淆 ， 最 好 是 将 代码 部 署 到 专门 的 服务 器 空间 上 去 。 这 些 工 作 可 以 实现 一 键 操作 。 


Nodejs 圈 子 里 有 两 个 最 为 流行 的 工具 : 一 个 是 grunt， 出 现 得 最 早 ; 另 一 个 是 gulp， 后 来 者 居 上 ， 号 称 是 为 了 解决 前 者 的 问题 而 生 的 。 


gulp。 


1. 原 理 


dl 


实证 明 ，gulp 确 实 很 好 用 ， 简 单 又 高 效 ， 笔 者 所 用 的 就 是 


gulp 的 核心 概念 就 是 管道 流 ， 可 以 将 管道 流 理解 成 生活 中 的 各 种 管道 的 概念 ， 比 如 自来水 管道 。 文 件 或 数据 就 是 水 ，gulp 等 各 类 插件 就 是 过 滤 网 等 水 处 理 器 械 。 


设计 一 个 任务 ， 就 相当 于 建设 一 条 管道 ， 将 会 涉及 6 个 方法 ， 具 体 如 下 。 


1) 构建 管道 并 为 管道 起 一 个 好 记 的 名 字 ， 要 使 用 的 方法 为 gulp.task () 。 


2) 管道 入 口 方法 gulp.src () (其 中 src 代 表 源 文件 ) 。 


3) 每 一 节 管道 .pipe () (要 用 在 入 口 和 出 口中 间 ， 在 其 中 放 入 各 种 插件 方法 ， 相 当 于 加 了 层 过 滤 网 ) 。 


4) 一 直流 向 管道 出 口 ， 方 法 为 gulp.dest () 其 中 dest 的 英文 意思 是 目标 ) 。 


5) 用 gulp.watch 监 控 水 流 变 化 (文件 变化 ) 。 


6) 用 gulp.run 综 合 调度 各 个 管道 的 运行 ， 最 后 用 gulp 或 gulp taskname 命 令 在 命令 行 启动 管道 。 


如 图 6-7 所 示 ， 我 们 先 来 看 看 下 面 的 几 条 管道 ， 是 不 是 很 容易 理解 。 


POTOEETEETTTEETTEEEET -fm 


单个 输出 和 检测 。 多 个 输出 增 量 重新 构建 


gutp = {gulp); ”gulp = gulp’); gulp = 
coflee = requre(gulp-cofiee); uloprofixer = ‘(gulp-autopreficer); cached = 
vgity = ‘gulp-uglity); » minifyCss = ‘equ re('gulp-minify-css’); We vglfy = 
rename = (gulp-rename); 
gulp tasx( 和 6 0 人 ', 
gulp src(Jjslsrcr .coflee’) prori 
Pipe(cotiee()) 
Pipe(uglity0) 
Pipe(gulp destf AI); 
gulp.dast 
gulp.watch(' /s/src/” coffee', [js"); 
hohe hn eh he bn hh hn hh hn os one he ne es ee es oe one hse ne ee hee oes hs one en hn he bo es nnn hs dhs hh es oe eh 
: gulp.task(Css,, [Yont, ess hncson0{ 1 


gulp.dast 


uglify |gulp.de 夸 


图 6-7 gulp 几 种 常用 的 管道 模式 
注意 pipe 管道 ， 是 Linux 或 Nodejs 等 对 于 文件 处 理 的 一 个 重要 概念 ， 后 面 的 章节 将 会 对 管道 做 进一步 说 明 。 


2. 安 装 


首先 ， 输 入 如 下 代码 : 


$ cnpm install gulp --global 


这 里 使 用 --global 进 行 全 局 安装 ， 这 样 我 们 才 可 以 在 任何 路 径 下 使 用 gulp 命 令 。 


然后 ， 输 入 如 下 代码 : 


$ cnpm install gulp --save-dev 


这 里 表示 安装 在 工程 目录 下 ， 目 的 是 方便 管理 。 同 时 ， 因 为 gulp 仅 仅 是 开发 辅助 工具 ， 只 在 本 地 开发 机 器 上 使 用 ， 因 此 上 述 命令 添加 --save-dev 选 项 ， 把 gulp 模 块 安装 在 开发 依赖 里 。 


3. 建 管道 


gulp 命 令 默认 请 求 gulpfilejs 文 件 ， 下 面 来 手动 建立 一 个 管道 ， 上 面 所 说 的 各 类 管道 (任务) 都 在 这 个 文件 里 ， 本 工程 对 管道 “js” 进行 处 理 的 代码 如 下 : 


-=--- 其 他 代码 -~---- 
// 新 建 管道 ， 命 名 为 js 
gulp.task('js', ['clean'], function() { 


// 合并 、 压 缩 、 混 淆 ， 并 复制 js 文件 
return es.merge (// 这 是 一 个 workflow 插 件 ， 是 Node .js 模块 ， 当 然 也 可 以 使 用 了 
gulp.src (assets.js.vendor) // 管道 1 入 口 
.Pipe (gulp.dest (settings.destFolder + '/js/')), 
// 直接 流 到 管道 1 出 口 ， 相 当 于 简单 复制 


gulp.src(assets.js.paths) // 管道 2 入 口 
.pipe (order (assets.js.order)) // 过 滤 网 1: 排序 
.pipe (sourcemaps.init ()) // 过 滤 网 2， 建 sourcemap: 
.pipe (uglify ()) // 这 算是 管道 中 的 管道 了 ， 过 滤 网 3: 混淆 处 理 
.pipe (concat (settings.prefix.destfile + '.js')) // 过 滤 网 4: 合并 处 理 
.pipe (sourcemaps .write ()) // 建 maps 结 束 ， 输 出 sourcemaps 
.pipe (gulp.dest (settings.destFolder + '/js')) // 管道 2 出 口 
) 
.Pipe (concat (settings .Prefix.mergefile + '.js')) 
/ 汇总 管道 : 对 上 述 两 个 管道 的 输出 进行 再 合并 
.Pipe (gulp.dest (settings.destFolder + '/js/')) // 汇总 管道 出 口 
---- 其 他 代码 ----- 


详情 请 看 源码 。 


在 命令 行 中 ， 输 入 如 下 命令 ， 运 行 该 任务 : 


$ gulp js 


4 插件 


上 述 代码 中 用 到 的 order、sourcemaps 和 uglify 对 应 了 3 个 gulp 揪 件 ， 可 以 从 官网 找到 ， 本 工程 所 涉及 的 是 几 个 最 常用 的 插件 ， 具 体 如 下 : 


"gulp-concat": "^2.6.0", // 合并 js、css 等 


"gulp-cssnano" // css 讨 缩 ， 取 代 了 gulp-minify-css 

// 部 署 到 Github 的 "gh-pages'， 本 工程 在 线 演示 就 是 这 么 部 署 的 
A // 图 片 压缩 

"gulp-order": 和 js、css 等 顺序 合并 等 

"gulp-processhtml" // 将 处 理 完 的 代码 ， 替 换 到 .html、.ejs 等 模板 文件 里 
"gulp-sourcemaps": "^1.6. // 产生 sourcemaps 文 件 

"gulp-uglify": "^1.5.1", // 混淆 和 压缩 js 文件 


5. 部 署 


上 面 的 插件 列表 里 ， 有 一 个 名 为 gulp-gh-pages 的 插件 ， 可 以 部 团 到 Github 的 静态 网 站 服务 gh-pages: 


Var ghPages = require('gulp-gh-pages'); 


// Deploy 

gulp.task('deploy', function() { 
return gulp.src('./dist/**/*') 

yi .pipe (ghPages () ); 


运行 如 下 命令 ， 即 可 : 


$ gulp deploy 


当然 ， 最 好 在 运行 部 署 命令 之 前 ， 先 运行 合并 、 压 缩 等 处 理 命令 ， 如 果 想 省 事 ， 那 就 定义 在 上 述 部 署 任务 里 ， 具 体 请 参考 源码 。 


6.5 总 结 


/GAN= 口 


回顾 本 章 的 每 一 个 小 节 ， 其 实 都 可 以 用 一 章 的 篇 幅 来 进行 详细 说 明 。 缺 乏 细节 会 让 读者 特别 是 新 手 ， 理 解 起 来 很 辛苦 。 相 反 ， 太 注重 细节 ， 又 会 让 我 们 失去 主题 。 所 以 ， 对 于 细节 的 把 控 是 一 个 很 难 取 
舍 的 过 程 ， 欢 迎 广大 读者 提供 宝贵 的 意见 或 建议 。 


dl 


上 提供 了 完整 的 程序 源码 。 源 码 所 提供 的 功能 比 本 章 所 描述 的 更 多 更 全 面 ， 比 如 对 输入 框 的 处 理 、 
容 ， 在 阅读 的 时 候 ， 要 注意 结合 源码 来 理解 ， 实 在 不 明白 请 参考 6.6 节 提供 的 资源 ， 或 者 直接 联系 笔者 。 


件 的 监听 、 多 数据 格式 的 处 理 ， 还 包括 bootstrap 的 使 用 等 。 限 于 篇 幅 ， 本 章 仅 摘录 了 部 分 核心 内 


现在 ， 您 应 该 可 以 自己 动手 实践 了 ， 应 该 能 够 轻松 地 把 比特 时 代 、OKCoin 等 交易 市 场 的 交易 行情 ， 即 时 显示 在 自己 的 网 站 上 了 。 如 果 时 间 和 精力 允许 ， 建 议 再 掌握 一 些 比特 币 的 核心 代码 ， 它 提供 了 很 
多 API， 对 于 这 些 API 也 可 以 像 本 章 所 讲 的 这 样 直接 读 取 ， 所 以 开发 一 个 区 块 链 浏览 器 ， 比 如 blockchain.info， 也 不 是 特别 困难 的 事情 。 


那么 ， 具 体 该 如 何 操作 呢 ? 第 7 章 将 简单 介绍 Node.js 后 台 开 发 实践 ,编写 Node.js 模 块 ， 为 后 续 的 代码 分 析 打 好 基础 。 


1 参考 用 例 


d3.layout.treemap: http://mbostock.github.io/d3/talk/20111018/treemap.html 


Grouped horizontal bar chart: http://bl.ocks.org/erikvullings/51cc5332439939f1f292 


2. 官 方 网 站 


Node.js 官 方 网 站 : https://node.js.org/ 


Bower 官 方 网 站 : http://bower.io/ 


D3.js 官 方 网 站 : https://d3js.org 


3. 其 他 文档 


XxCharts 一 个 封装 D3.js 的 


出 


表 展 示 包 : http://tenxer.github.io/xcharts/ 


《大 数据 时 代 的 图 表 可 视 化 利器 一 一 highcharts、D3 和 百度 的 echarts》: http://www.thebigdata.cn/JieJueFangAn/12972.html 


D3 的 使 用 心得 和 学 习 资 料 汇 总 : http://www.storagelab.org.cn/zhangdi/2014/08/23/d3 可 视 化 实战 00: d3 的 使 用 心得 和 学 习 资 料 汇总 / 


第 7/ 章 ”Node.js 让 后 台 开 发 像 前 端 一 样 简单 


写作 本 章 时 ， 比 特 币 社区 发 生 了 一 件 事 ， 比 特 币 核心 开发 者 Mike Hearn 发 文 称 比 特 币 实验 失败 了 ， 比 特 币 交 易 价格 应 声 大 跌 ， 比 特 币 的 未 来 将 何去何从 ， 很 多 人 又 一 次 陷入 了 迷茫 。 面 对 这 些 ， 笔 者 反 


而 更 加 坚定 了 信心 。 这 件 事 充分 说 明 一 个 产品 有 它 的 生命 周期 ， 也 有 失败 的 风险 ， 一 项 技术 却 永远 前 进 在 路 上 。 无 论 产品 消亡 与 否 (当然 ， 比 特 币 是 不 会 那么 轻易 就 消亡 的 ) ， 都 会 留 下 丰厚 的 技术 遗产 。 
在 此 ， 笔 者 希望 个 人 的 技术 分 享 能 为 这 句 话 做 个 见证 。 


第 6 章 简单 介绍 了 Nodejs， 搭 建 了 开发 环境 ， 并 轻松 完成 了 前 端 开发 。 本 章 将 更 进一步 ， 介 绍 如 何 实现 更 加 复杂 的 业务 逻辑 ， 如 何 构建 自己 的 APl。 


为 什么 要 用 后 台 ? 就 我 们 的 这 个 统计 分 析 项 目 (SACDL 项 目 ) 而 言 ， 只 需要 前 端 几 个 文件 就 已 经 足够 了 。 但 是 ， 大 多 数 项 目的 业务 更 加 复杂 ， 没 有 后 台 将 无 法 完成 对 复杂 业务 的 处 理 。 


另外 ， 前 端的 处 理 能 力 有 限 ， 特 别 是 Web 应 用 ， 前 端 代码 越 简单 越 好 ， 对 于 性 能 和 用 户 体 验 都 有 好 处 。 反 观 我 们 的 SACDL 项 目 ， 显 然 对 于 数据 的 整理 更 适合 放 在 后 台 进行 。 


再 者 ， 大 家 知道 ，Bitcoin 或 其 他 竞争 币 的 核心 通常 会 提供 JSON 格 式 的 API， 我 们 只 要 在 后 台 对 这 些 API 进 行 操作 ， 即 可 实现 自己 的 业务 逻辑 ， 就 能 很 轻松 地 实现 区 块 链 浏览 器 (如 blockchain.info) 、 
钱包 、 支 付 等 基本 应 用 。 因 此 ， 学 习 如 何 处 理 第 三 方 AP1， 对 于 我 们 快速 上 手 基于 区 块 链 的 开发 应 用 是 有 直接 帮助 的 。 


7.1 需求 


明确 项 目的 需求 ， 这 一 点 很 重要 。 假 设 项 目 有 如 下 需求 : 


1) 从 后 台 读 取 github.com 的 APl。 
2) 处 理 读 取 的 数据 ， 并 发 送 给 前 端 。 


很 明显 ， 我 们 需要 重 构 前 端 代码 。 


7.2 开发 


本 节 仍 以 SACDL 工 程 为 例 ， 引 入 Express 框 架 ， 并 以 此 为 基础 进行 开发 重 构 。 


基于 Node.js 的 开发 框架 有 很 多 ， 而 Express 是 最 基础 、 最 出 众 的 一 个 ， 很 多 其 他 的 框架 都 是 基于 它 构 建 而 来 的 ， 比 如 严格 模仿 Ruby on Rails 的 Sails 框 架 、Meteor 等 。 


7.2.1 安装 Express 


可 通过 如 下 命令 安装 Express: 


$ cnpm install express --save 


安装 Nodejs 模 块 时 ， 如 果 指定 了 --save 参 数 ， 那 么 此 模块 将 被 添加 到 package.json 文 件 中 的 dependencies 依 赖 列表 中 。 以 后 ， 就 可 以 通过 npm install 命 令 自 动 安装 依赖 列表 中 列 出 的 所 有 模块 了 。 


7.2.2 ”创建 简单 应 用 


进入 工程 目录 ， 新 建文 件 appjs， 输 入 如 下 内 容 : 


Var express = require('express'); 
Var app = express (); 


app.get ('/', function (req, res) { 
res.send('Hello World!'); 
])3 


Var server app.1isten(3000，function () { 
Var host Server.address () .address; 
Var port = server.address () .Port; 


console.1log('Example app listening at http:// %s:%s', host, port); 


然后 ， 运 行 如 下 命令 : 


$ node app.Jjs 


最 后 ， 用 浏览 器 打开 http://localhost: 3000/， 可 以 看 到 “Hello World! ”的 输出 。 


这 是 官网 的 例子 ， 是 一 个 完整 的 Web 应 用 。 也 可 以 将 其 理解 为 一 个 服务 器 软件 ， 只 不 过 是 仅 在 3000 端 口 ， 提 供 了 一 个 简单 的 Web 服 务 。 


如 果 你 已 经 对 第 6 章 所 提 到 的 gulp 的 管道 概念 有 了 一 定 的 认识 ， 那 么 也 可 以 理解 为 我 们 已 经 搭建 了 一 条 从 后 台 到 前 端的 管道 。 剩 下 的 工作 就 是 为 这 条 管道 添加 各 种 处 理 装置 ， 让 水 流 (数据 流 ) 实现 我 
们 的 要 求 。 关 于 流 的 概念 ， 我 们 会 在 第 8 章 再 次 进行 说 明 。 


7.2.3 ”使 用 模板 引擎 


7.2.2 节 所 示 的 代码 直接 将 “Hello World! ”发 送 给 了 浏览 器 ， 如 果 是 HTML 文 件 ， 又 该 怎么 做 呢 ?Node.js 没 有 直接 泻 染 模板 的 功能 ,需要 用 到 第 三 方 插件 ， 如 jade、ejs、hbs 等 。 


这 里 采用 的 是 ejs， 它 就 像 Java 的 jsp， 或 者 Rails 的 rhtml 一 样 ， 可 以 直接 在 HTML 文 件 里 嵌入 代码 ， 简 单 又 好 用 。 下 面 来 安装 ejs 揪 件 ， 代 码 如 下 : 


$ cnpm install ejs --save 


然后 ， 用 app.set 设 置 第 一 个 管道 过 滤器 ， 修 改 上 述 代 码 为 如 下 形式 : 


人 其 他 ------- 
app.set ('views', './views') 
app.set ('view engine', 'ejs') 


app.get ('/', function (req, res) { 


res.render ('index'); 


然后 新 建 一 个 views 文 件 夹 (把 视图 文件 暂时 放 在 这 里 ) ， 在 views 里 新 建 index.ejs， 打 开 它 ,把 “hello imfly! ”复制 过 去 。 


”， 证 明 模板 启用 成 功 。 


启 服务 器 (Ctrl+C 关 闭 ， 然 后 再 用 node app 命 令 打 开 ) ， 刷 新 浏览 器 ， 可 以 看 到 原来 的 “Hello World! ” 变 成 了 “hello imfly! 


时 


7.2.4 “使 用 静态 文件 服务 
量 启 并 刷新 ， 没 想到 出 现 了 一 堆 乱 码 ， 这 时 按 下 F12， 打 开 浏 览 器 控制 


目前 ， 前 端 只 有 publiwindex.html 文 件 。 现 在 ， 将 它 的 代码 复制 到 viewsVindex.ejs 文 件 里 ， 并 修改 JavaScript、CSS 引 用 。 然 后 是 


台 ， 将 会 看 到 提示 404 错 误 ， 说 明 Javascript、CSS 文 件 都 没有 成 功 加 载 ， 这 是 怎么 回 事 呢 ? 
到 目前 为 止 ， 仅 提供 了 “/” 地 址 下 的 路 由 请 求 ， 对 于 其 他 任何 地 址 ，Node.js 都 默认 转向 404 错 误 。 怎 么 办 ? 逐个 去 添加 吗 ? 显然 不 是 ， 对 于 这 类 静态 文件 ，Express 提 供 了 简单 的 解决 方法 : 


app.use (express.static('./public', { 
maxAge: '0', // no cache 
etag: true 

1)); 


app.get ('/', function (req, res) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


这 里 使 用 的 是 第 二 个 管道 过 滤器 ， 上 面 代码 的 意思 是 ，public 下 的 文件 ， 包 括 JavaScript、CSS、lmages、Fonts 等 都 当 作 静态 文件 来 处 理 ， 根 路 径 是 “./public”， 请 求 地 址 就 相当 于 “/”， 例 
如 “./public/js/appjs” 文 件 ， 其 请 求 地址 就 是 http://localhost: 3000/js/app.js。 
侠 说 明 这 里 有 一 个 小 问题 ， 使 用 bower 安 装 的 前 端 第 三 方 开发 包 ， 都 在 bower_components 文 件 夹 下 ， 需 要 将 其 移 到 public 文 件 夹 里 。 然 后 ， 添 加 一 个 .bowerrc 文 件 ， 告 诉 bower 组 件 安装 目录 已 经 发 生 了 


改变 ， 同 时 还 需要 修改 gulpf|ile.js 文 件 。 当 然 也 可 以 连同 bower.json 文 件 都 移 到 public 文 件 夹 里 。 


重启 服务 ， 刷 新 页 面 ， 现 在 终于 可 以 看 到 久违 的 页 面 了 ， 如 图 7-1 所 示 。 


掉 、 加 空 货币 开发 语言 统计 分 t x 


€ > CCID 1ocalhost:3000 


Github 开 发 语言 统计 分 析 


图 7-1 浏览 器 请 求 动态 文件 并 查看 效果 


7.2.5 ”后 台 请 求 Github API 
Nodejs 的 request 插 件 ， 就 可 以 直接 在 后 端 请 求 HTTP 地 址 ， 这 样 做 相当 于 直接 把 前 端 代码 拿 到 了 后 台 。 不 过 ， 这 里 还 有 一 个 更 好 的 解决 方案 ，Github 提 供 了 


在 后 台 请 求 Github 也 有 很 多 种 方案 ， 使 有 
Nodejjs 使 用 的 开发 包 ， 可 以 直接 使 用 ， 代 码 如 下 : 


$ cnpm install github --save 


官方 地 址 : https://github.com/mikedeboer/node-github。 


怎样 才能 想到 这 个 方案 ”一 种 方法 是 ， 认 真 阅读 官方 文档 ， 看 看 官方 提供 了 什么 资源 ; 另 一 种 方法 是 ， 经 常 去 https//npmjs.com 上 搜 搜 。 通 常 ， 一 个 成 熟 的 产品 一 般 都 会 提供 一 些 现成 的 方案 。 


该 组 件 几乎 集成 了 Github API 的 全 部 内 容 ， 当 然 也 包括 搜索 功能 。 下 面 就 来 实验 一 下 ， 把 下 面 的 代码 复制 到 appjs 中 : 


Var GitHubApi = require ("github"); 
// 把 下 面 的 代码 放 在 app.get ('/'，http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/OEBPS/Text/...) 之 前 


app.get ('/search', function(req, res){ 
Var msg = 
q: 'bitcoin’', 
Sort: 'forks', 
order: 'desc', 
per_ page: 100 
} 
github.search.repos (msg，function (err，data) { // 这 里 必须 用 ' 回 调 ' 函 数 ， 不 能 使 用 var data = http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompres 


res.json(data); // 输出 JSON 格 式 的 数据 


]) 
入 


在 浏览 器 里 请 求 http://localhost: 3000/search， 可 以 看 到 与 请 求 https://api.github.com/search/repositories?q=bitcoin&sort=forks&order=desc&per_page=100 一 样 的 结果 (样式 可 能 会 有 所 


不 同 ) 。 
http://localhost: 3000/search 就 是 我 们 自己 的 API 服 务 ， 如 果 有 自己 的 数据 库 或 其 他 逻辑 业务 ， 数 据 将 会 很 容易 融合 进去 。 


让 前 端 请 求 这 个 APl， 将 public/js/appjs 34 行 的 代码 修改 如 下 : 


url = url || 'http:// localhost:3000/search'; // 默认 请 求 的 页 面 


在 浏览 器 里 请 求 http://localhost: 3000/， 结 果 与 原来 相同 。 这 样 就 简单 实现 了 在 后 台 处 理 数据 ， 在 前 台 展示 数据 的 功能 。 


7.2.6 ”模块 化 重 构 


到 目前 为 止 ， 我 们 所 做 的 都 是 在 修改 app.js， 不 断 往 里 面 添加 各 种 管道 过 滤器 。 如 果 业 务 复杂 ， 那 么 这 个 文件 将 会 非常 大 。 事 实 上 ， 任 何 一 个 Node.js 应 用 ， 都 可 以 压缩 成 这 样 一 个 JavaScript 文 件 。 这 


时 就 能 轻松 理解 ， 为 什么 大 多 数 JavaScript 框 架 都 习惯 带 着 js 后 级 了 一 一 因为 它 本 身 就 是 一 个 JavaScript 文 件 。 


但 是 这 样 做 并 不 适合 开发 和 维护 。 我 们 需要 把 它 分 解 成 单个 的 、 独 立 的 文件 ， 通 过 名 字 就 能 分 辨 出 它 的 用 处 ， 并 且 通 过 名 字 就 能 直接 调用 它 ， 这 就 是 Node.js 的 模块 化 开发 。 


Nodejs 的 模块 化 非常 简单 。 记 住 这 样 一 个 简单 的 逻辑 关系 : 通常 一 个 module.exports 可 以 定义 为 一 个 模块 ; 一 个 文件 只 包含 一 个 模块 ; 只 要 是 模块 就 可 以 使 用 require () 方法 在 
式 与 前 端 代码 非常 相似 ， 具 体 如 下 : 


他 地 方 引用 它 。 样 


// 文件 /path/to/moduleName.js 


// 局 部 变量 

vara= "" 

// 公共 方法 (直接 导出 模块 

var moduleName = {} 或 function(){} // 总 之 就 是 一 个 对 象 

// 私有 方法 

function funl (){)} 

// 导出 模块 

module .exports = moduleName; 

在 其 他 文件 中 ， 我 们 可 以 这 样 调用 : 

var moduleName = require('/path/to/moduleName'); ”// 默认 js 后 级 ， 习 惯 不 用 带 后 级 


// 然后 ， 直 接 调用 moduleName 的 各 个 对 象 或 方法 就 是 了 


按照 这 种 方式 ， 可 以 把 app.js 文 件 ， 拆 分 成 典型 的 MVC 的 开发 样式 ， 比 如 ,熟悉 Ruby on Rails 的 朋友 ， 都 习惯 于 把 代码 分 开 保存 在 controllers、models 和 views 文 件 夹 里 ， 这 里 我 们 仿效 之 。 视 


定义 在 了 views 文 件 夹 下 ， 下 面 我 们 重点 拆 分 其 他 的 。 


1. 拆 分 模型 


模型 (model) 专门 用 于 处 理 数据 ， 无 论 是 数据 库 ， 还 是 请 求 远程 API 资 源 ， 都 应 该 是 模型 所 处 理 的 事 。 自 然 ， 我 们 可 以 把 Github API 的 请 求 独立 出 来 ， 放 在 模型 里 ， 具 体 做 法 如 下 。 


新 建文 件 app/models/repojs， 然 后 剪 切 并 粘贴 下 面 的 代码 : 


网 
un 


Var GitHubApi = require ("github"); 


xx 
* from https:// www.npmjs.com/package/github 
* @type {GitHubApi} 

Rf 


Var github = new GitHubApi ({ 
// required 
version: "3.0.0", 
// optional 
debug: false, 
protocol: "https", 
host: "api.github.com", // should be api.github.com for GitHub 
PathPrefix: "", // for some GHEs; none for GitHub 
timeout: 5000, 
headers: { 
"user-agent": "My-Cool-GitHub-App" // GitHub is happy with a unique user agent 
i 


Var Repo = { 
search: function(msg, callback) { 
Var msg = msg || { 
SR "biteoin’, 
sort: 'forks', 
order: 'desc', 
Per Page: 100 


github.search.repos (msg, callback); 
} 


module.exports = Repo; 


@w 模型 是 资源 的 集合 ， 就 像 数 据 库 里 的 一 张 表 ， 命 名 自然 用 资源 类 的 名 词 来 表示 最 好 。 因 为 对 数据 的 增删 查 改 都 在 模型 里 了 ， 因 此 在 前 端 public/js/utils.js 里 的 部 分 代码 就 应 该 转移 到 这 里 ， 从 而 


直接 输出 treemap 的 数据 格式 ， 例 如 : 


// from /public/js/utils.js 
function treeDatal(data) { 
var languages = {}; 


Var result = { 
"name": "languages", 
"children": [] 

} 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


2. 拆 分 控制 器 


控制 器 负责 从 模型 请 求 数据 ， 并 把 数据 发 送 到 前 端 ， 是 前 端 和 后 台 的 调度 员 。 这 里 ，app.get 方 法 里 的 匿名 函数 便 是 控制 器 ， 下 面 分 别 把 它们 抽取 出 来 ， 放 在 app/controllers/repos:js 生 
替代 请 求 Github API 的 代码 ， 代 码 如 下 : 


Var Repo = require('http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/../models/repo'); 


Var Repos = { 
// get '/' 
index: function(req, res) { 
res.render ('index'); 


}, 


// get '/search' 
search: function (req res) { 
Repo.search (req.query.query, function(err, data) { 
res.json (data); 


D) 


里 ， 并 用 模型 来 


module.exports = Repos; 


@i 按照 惯例 ， 控 制 器 的 名 称 通常 是 对 应 模型 的 名 称 〈 名 词 ) 的 复数 ; 行为 的 名 称 通 常 是 动作 (动词 ) ， 因 此 repos.index 就 表示 版 本 库 列表 ，repos.search 就 是 搜索 版 本 库 信息 ， 在 app.js 中 ， 自 然 可 
以 这 样 调用 : 


一 -其 他 代码 


Var repos = require('./app/controllers/repos'); 


app.get ('/search', repos.search); 
app.get('/', repos.index); 


一 一- 其 他 代码 ---- 


这 部 分 代码 的 作用 是 分 发 路 由 ， 因 此 应 该 在 路 由 里 ， 于 是 继续 重 构 。 


3. 拆 分 路 由 


新 建文 件 app/routerjs， 把 上 面 的 代码 剪 切 过 来 ， 修 改 如 下 : 


Var repos = require('./controllers/repos'); 
Var Router = function (apP) { 


app.get ('/search', repos.search); 
app.get ('/', repos.index); 


module.exports = Router; 


然后 在 app.js 里 简单 调用 : 


Var router = require('./app/router'); 


router (app); 


后 续 再 添加 其 他 的 任何 路 由 ， 只 要 修改 routerjs 就 可 以 了 。 


4. 整 理 视图 


把 views 整 体 移动 到 app/views 下 ， 并 修改 appjjs 代 码 ， 让 模板 引擎 指向 该 文件 夹 ， 代 码 如 下 : 


app.set ('views', './app/views') 


然后 ， 新 建 app/views/repos 文 件 夹 ， 将 views/index.ejs 文 件 移入 。 


说 明 : 视图 (view) 是 界面 元 素 ， 通 常 是 类 HTML 文 件 ， 按 照 惯 例 ， 它 的 文件 夹 与 控制 器 同名 repos， 各 文件 名 与 控制 器 的 行为 action 同 名 ， 如 index 一 index.ejs 


当然 ， 视 图 根据 模板 引擎 的 特点 ， 也 可 以 进行 模块 化 处 理 ， 进 一 步 细 化 为 layout.ejs、header.ejs 等 ， 以 便于 重复 使 用 。 限 于 篇 幅 ， 这 里 不 再 叙述 ， 如 要 了 解 相关 详情 ， 请 看 源码 。 


经 过 这 样 的 模块 化 整理 ， 就 能 轻松 实现 一 个 简单 的 MVC 框 架 (如 图 7-2 所 示 ) ， 它 的 易 用 性 、 可 扩 | 


展 性 都 得 到 了 很 大 的 提升 。 现 在 ， 我 们 已 经 可 以 快速 添加 更 多 的 功能 了 ， 比 如 像 某 些 网 站 那样 显示 主 
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(3) 逻辑 业务 
(4) 存 取 数据 本 


> 
数据 库 


We 


呐 型 


Record&Model 


图 7-2 SACDL 工 程 的 MVC 框 架 图 


7.2.7 ”测试 和 部 署 


"= > 
(2) 请 求 = 


没有 经 过 测试 的 产品 不 能 称 为 真正 的 产品 。 不 过 由 于 本 章 篇 幅 所 限 ， 关 于 产品 的 测试 和 部 署 这 一 部 分 都 暂且 略 过 。 因 为 本 项 目 仅 作 辅 助 之 用 ， 不 能 作为 真正 的 产品 来 使 用 。 如 果 非 要 作为 产品 之 用 ， 那 


么 建议 你 最 好 能 做 一 下 测试 ， 不 然后 果 自 负 。 


在 此 ， 笔 者 个 人 还 有 一 个 小 问题 没有 得 到 解决 ， 那 就 是 ， 如 果 你 的 电脑 需要 代理 上 网 ， 那 么 通过 Nodejjs 请 求 api.github.com 可 能 会 不 成 功 ， 请 注意 辨别 和 自行 解决 。 如 果 希 望 每 个 细节 都 完美 ， 那 么 
最 终 的 结果 往往 就 会 不 完美 。 很 多 程序 员 在 某 个 时 期 会 不 自觉 地 陷入 技术 细节 ， 而 忽略 了 研发 的 初 表 。 最 遗憾 的 是 ， 很 多 人 一 开始 就 试图 解决 所 有 的 问题 ， 结 果 是 最 终 拿 不 出 一 个 完整 的 产品 ， 像 样 的 产品 


就 更 不 用 说 了 ， 所 以 ， 时 刻 专 注 在 最 有 价值 的 事情 上 并 把 它 实现 才 是 最 重要 的 。 


7.3 总 结 


/GAN= 口 


本 章 所 涉及 的 代码 非常 简单 ， 但 在 尽量 严格 控制 字数 的 情况 下 ， 仍 然 叙 述 了 这 么 多 。 所 以 ， 很 多 时 候 ， 语 言 的 力量 非常 苍白 ， 说 得 再 多 也 不 如 动手 实践 一 下 。 


本 章 对 输入 框 的 处 理 没 有 做 进一步 说 明 ， 请 大 家 自行 查看 源码 。 关 于 模块 化 的 部 分 ， 其 实 已 经 存在 一 个 名 为 express-generator 的 命令 行 工具 ， 可 以 一 键 生成 新 工程 目录 ， 就 不 


我 们 自己 去 拆 分 了 。 还 


有 很 多 优秀 的 资源 ， 请 大 家 自行 探索 。 总 体 来 说 ， 使 用 Node.js， 从 前 端 到 后 台 都 不 复杂 。 前 后 语言 的 统一 减少 了 很 多 思维 转换 的 麻烦 。 如 果 你 能 完整 实践 第 6、7 两 章 的 内 容 ， 笔 者 个 人 认为 ，Nodejs 应 该 


可 以 入 门 了 。 


但 是 ， 如 果 想 要 看 明白 一 些 复杂 的 代码 ， 还 需要 掌握 Nodejjs 的 一 些 独特 习惯 ， 比 如 回调 、 对 异常 的 处 理 等 ， 具 体内 容 参见 第 8 章 。 第 8 章 将 仍 以 SACDL 项 目 为 例 ， 添 加 展示 主流 交易 市 场 信息 等 功能 ， 


目标 是 简单 介绍 一 些 大 家 经 常会 遇 到 的 “ 坑 ” ， 以 便 在 接 下 来 的 代码 分 析 中 能 够 更 加 轻松 。 


7.4 参考 


Expressjs 官 网 : http://expressjs.com/ 


第 8 章 ”你 必须 知道 的 几 个 Node.js 编 码 习 惯 


第 6 章 和 第 7 章 均 以 SACDL 项 目 为 例 ， 简 单 介 绍 了 Nodejs 的 环境 搭建 和 代码 组 织 。 本 章 将 做 一 个 简单 的 小 结 ， 对 涉及 的 编码 习惯 ,以 笔者 个 人 的 理解 提示 性 地 说 明 一 下 。 


编程 其 实 就 是 用 特定 的 语言 讲 故事 、 写 规则 。 这 里 的 特定 就 是 习惯 ， 就 像 方言 一 样 ， 掌 握 了 技巧 ， 很 快 就 可 以 和 说 不 同方 言 的 人 进行 交流 ， 剩 下 的 细节 慢 慢 积累 。 


比特 币 体现 了 人 类 去 中 心 化 的 本 质 ，Nodejjs 也 是 最 能 体现 人 类 特质 的 编程 语言 之 一 ， 比 如 一 切 都 是 数据 流 ， 事 事 皆 回调 等 。 下 面 就 来 详细 讲解 Nodejs 的 编码 习惯 。 


8.1 一 切 都 是 数据 流 


1 .概念 理解 


Nodejs 默 认 提 供 了 Stream 模 块 ， 即 流 模块 ， 第 6 章 讲解 gulp 的 时 候 曾 提 到 过 ， 作 为 一 个 抽象 接口 ，Stream 模 块 是 Nodejs 的 基础 模块 ， 并 被 其 他 很 多 模块 所 使 用 。 


流 ， 最 早 是 Linux 环 境 下 的 概念 ， 与 之 对 应 的 方法 通常 是 pipe， 即 管道 方法 。 笔 者 个 人 认为 ， 这 种 设计 非常 形象 合理 。 流 的 概念 存在 于 人 类 生活 的 大 部 分 场景 中 ， 数 据 流 也 与 水 流 、 空 气流 等 具有 相同 的 
特性 ， 具 体 如 下 。 


“ 流 兼 具 时 间 和 地 点 两 个 坐标 ， 时 间 代表 一 个 过 程 ， 地 点 代表 流入 、 流 出 〈 对 应 于 发 生 、 结 束 的 编码 ) 的 位 置 。 
: 流 是 一 个 时 间 上 的 线性 过 程 ， 而 非 一 个 时 间 点 。 在 一 个 时 间 段 内 的 传输 只 是 部 分 数据 ， 若 要 获得 完整 的 数据 ， 就 需要 花费 足够 长 的 时 间 。 


“ 流 只 能 沿 着 构建 在 从 发 生 到 结束 的 编码 位 置 的 管道 进行 传输 ， 在 传输 的 过 程 中 ， 流 可 以 被 调整 和 改变 。 


再 直 白 一 些 ， 流 不 可 能 一 下 子 发 生 或 结束 ， 再 快 也 得 有 个 时 间 差 。 就 像 人 类 社会 一 样 ， 始 终 都 是 以 时 间 为 单位 ， 这 一 刻 到 下 一 刻 已 经 发 生 了 变化 。 而 Nodejs 严 格 遵循 这 个 现实 ， 无 论 是 远程 访问 还 是 本 
地 请 求 ， 每 一 个 data 都 被 分 成 一 段 一 段 的 数据 流 (通常 是 Buffer 对 象 ) 进行 传输 。 


因此 ，Node.js 里 没有 简单 复制 的 概念 ， 或 者 说 复制 其 实 是 可 以 通过 流 来 简单 实现 的 。 


2. 代 码 示例 


比如 ， 下 面 的 代码 将 读 取 文件 test.md 的 内 容 ， 并 在 命令 行 窗口 打印 出 来 : 


// 引用 模块 
Var fs = require('fs'); 
Var iconv = require('iconv-lite'); 


Var rs = fs.createReadStream('test .md'); 
var chunks = [], 
size = 0; 


// 接收 数据 : 一 段 一 段 地 接收 数据 
rs.on("data", function (chunk) { 
chunks .push (Chunk) ; 
size += chunk.length; 


D); 
// 拼接 数据 :并 转化 为 utf-8 的 编码 格式 ， 这 样 就 能 支持 中 文 了 ， 否 则 会 显示 乱码 


rs.on("end", function() { 
var data = Buffer.concat (chunks, size); 
varstr = iconv.decode (data, ‘'utf8'); 
console.1og (data); 


}) 


其 实 ， 在 Express 的 编码 中 ， 默 认 也 是 在 处 理 buffer 数 据 流 ， 上 面 的 方法 也 同样 适用 。 


3. 思 维 习 惯 


记 住 ， 在 Nodejs 的 世界 里 ， 无 论 是 处 理 文件 ， 还 是 请 求 远程 资源 ， 处 理 的 都 是 “数据 流 ” ， 处 理 方法 都 是 如 此 。 为 了 直观 解释 ， 还 是 采用 第 6 章 里 那 张 管道 图 来 进行 说 明 吧 ， 如 图 8-1 所 示 。 


4 进一步 扩展 


因为 任何 流 都 是 时 间 的 函数 ， 因 此 为 了 节省 时 间 、 提 高 效率 ， 处 理 流 最 好 的 方式 当然 是 并 行 处 理 。 也 就 是 说 ， 每 一 个 流 最 好 都 使 用 一 个 独立 的 线程 ， 而 不 影响 其 他 的 流 。 事 实 上 ，Nodejjs 就 是 这 么 处 理 
的 ,这 就 是 8.2 节 所 要 讲 的 回调 。 回 看 一 下 本 节 所 示 的 代码 ， 就 是 典型 的 回调 用 法 。 


回 


回 


应 。 


及 | 


单个 输出 和 检测 | 首 量 重新 构建 


| 


. 

A gulp.task(Css’ [ont’ "ess], ion0( ' 

任 务 依赖 1 do something after font and less 1 
也 

' 


wy 


gulp = (guip); 
changed = (bulp-changed); 
vglily = (gulp-ughily); 


图 8-1 ”gulp 几 种 常用 的 管道 模式 


在 中 文中 ，“ 回 调 ” 这 个 词 很 难 一 下 子 就 能 让 人 理解 得 那么 透彻 。 其 实 ， 如 果 按 英文 “callback” 直 译 最 好 ，“ 调 回 ” 虽 然 直 白 , 但 是 更 好 理解 。 


“ 事 事 皆 回调 ”， 是 不 是 有 点 绝对 ? 其 实 不 然 ， 它 贯穿 于 人 类 沟通 交往 的 全 过 程 。 大 到 工程 项 目 ， 小 到 求助 问 路 ， 只 要 是 需要 别人 来 帮 你 做 的 事情 ， 就 必须 要 用 到 回调 ， 即 让 他 人 完成 并 获得 明确 的 回 
让 别人 为 你 做 某 件 事 ， 称 为 事件 触发 ; 给 出 一 个 方法 以 获得 该 事件 结束 后 的 结果 ， 就 是 回调 。 


举 个 典型 的 例子 : 假如 你 是 一 位 老板 ， 很 多 事情 都 需要 下 属 去 做 ， 然 后 你 需要 获得 结果 。 如 果 下 属 合格 ， 那 么 安排 的 事情 ， 他 (她 ) 会 按照 要 求 给 你 回应 ， 即 便 没 有 达到 预期 的 结果 ， 聪 明 的 下 属 也 会 
时 向 你 汇报 进展 。 但 现实 中 普遍 存在 的 现象 是 ， 你 所 安排 的 很 多 事情 并 不 能 得 到 及 时 的 回应 ， 这 时 候 你 就 得 亲自 过 问 ， 要 么 打 电 话 ， 要 么 派 秘书 或 办 公 室 人 员 去 追踪 ， 总 之 ， 要 有 一 条 通信 线路 让 你 得 到 


回馈 (无论 结果 是 好 是 坏 ) 。 


上 面 的 例子 中 ， 优 秀 员工 主动 汇报 工作 的 行为 ， 以 及 老板 打 电 话 或 派 人 查询 的 行为 ， 都 是 回调 方法 。 很 难 想象 ， 如 果 没 有 这 些 回调 ， 我 们 还 能 做 成 什么 事 ， 世 界 会 变 成 什么 样 。 一 些 国字 号 的 企业 ， 为 


什么 总 是 效率 低下 ? 几 个 人 干 着 其 他 公司 一 个 人 干 的 活 ? 真如 社会 批评 的 那样 是 懒散 、 不 干 活 吗 ” 不 尽 然 ， 其 中 大 部 分 原因 是 不 给 回调 (或 者 给 出 的 是 不 明确 的 回调 ) ， 让 你 无 从 干 起 。 


人 


因此 ， 一 个 优秀 的 老板 ， 一 定 是 一 个 会 选 人 、 用 人 和 培养 人 的 老板 ， 如 果 员 工 只 知道 埋头 干 活 ， 不 知道 及 时 反馈 信息 ， 老 板 一 定 得 有 自己 的 方法 应 对 ;一 个 优秀 的 员工 ， 一 定 是 一 个 让 老板 节省 脑力 的 
， 事 前 、 事 中 、 事 后 都 会 适时 汇报 情况 。 总 之 ， 只 要 想 做 事 、 做 成 事 ， 一 个 企业 或 组 织 总 会 自觉 地 对 信息 回调 的 方法 进行 优化 ， 以 降低 沟通 成 本 ， 提 高 效率 。 


具体 到 Nodejs 的 程序 ， 我 们 可 以 做 个 类 比 ， 主 线程 是 老板 ， 子 线程 (线程 池 ) 是 员工 ， 而 回调 则 是 它们 之 间 的 通信 方法 。 使 用 回调 的 代码 称 为 异步 编程 。 说 白 了 ， 就 是 做 自己 擅长 的 、 份 内 的 事 ， 其 他 


的 都 交 给 别人 去 做 。 即 对 主线 程 而 言 是 异步 ;而 从 局 外 人 的 角度 来 看 ， 则 是 在 同步 做 事情 。 


在 


@@ 济 Node.js 是 单 进程 的 (而 非 单线 程 ， 关 于 这 一 点 官网 解释 得 很 清楚 ) ， 只 不 过 我 们 写 的 JavaScript 代 码 只 在 单 ( 主 ) 线程 中 运行 村 了 ， 回 调 都 放 在 事件 轮 循 里 处 理 ， 而 事件 轮 循 等 底层 代码 是 运行 
多 线程 上 的 ( 即 大 家 公认 的 线程 池 ) 。 关 于 这 部 分 内 容 ， 建 议 大 家 深入 研究 一 下 官方 文档 。 


2. 代 码 示例 


回调 的 具体 形式 在 前 面 的 文章 中 已 经 用 过 多 次 了 ， 下 面 再 来 举 个 例子 类 比 一 下 。 


1) 在 进行 前 端 开发 时 ， 用 D3.js 通 过 Ajax 的 方式 请 求 数据 的 代码 可 以 简化 为 : 


d3.json('/resource.json', function(err, data){ 
// code 
console.log("Hello, ", data); 

])3 


Console.log("I`m end."); 


这 里 我 们 请 求 的 /resourcejson， 其 实 就 是 远程 服务 器 上 的 资源 http://localohost:3000/resource.json， 后 面 紧 跟 的 函数 就 是 回调 函数 ， 要 在 资源 请 求 (要 花费 一 些 时 间 ) 结束 之 后 才 会 被 调用 。 而 


console.log (“Il'm end.”) 与 d3json () 都 在 主线 程 中 ， 会 顺序 执行 ， 所 以 “Hello，” 必然 要 出 现在 “1m end.” 之 后 。 


2) 在 进行 后 台 开 发 时 ， 也 有 与 之 几乎 一 样 的 代码 : 


Var fs = requrie('fs'); 
fs.readFile('/resource.json', function(err, data){ 
// code 


console.log("Hello, ", data); 


]); 


console.log("I‘m end."); 


这 里 我 们 请 求 的 /resourcejson， 其 实 就 是 本 地 的 资源 resourcejson 文 件 ， 后 面 紧 跟 的 函数 也 是 回调 函数 ， 同 样 也 是 需要 在 资源 请 求 结束 之 后 才 会 调用 。 所 以 ，“Hello，” 也 会 出 现在 “lm end.” 之 


户 
已 。 


3. 思 维 习 惯 


在 Nodejs 的 世界 里 ， 到 处 都 是 回调 (大 多 数 都 是 使 


到 自己 已 掉 进 了 异步 的 陷阱 ， 忘 记 了 回调 。 


callback、next、cb 等 命名 回调 函数 ) ， 到 处 都 是 异步 ， 当 你 不 自觉 地 编写 了 如 下 的 代码 ， 经 过 反复 调试 却 得 不 到 data 预 期 的 结果 时 ， 就 要 意识 


Var fs = requrie('fs'); 
var data = fs.readFile('/resource.json'); // 异步 方法 


// code 


console.1log ("Hello, 


", data); 


console.1log("I'm end."); 


当然 ， 也 可 以 像 下 面 这 样 修改 上 面 的 错误 代码 : 


var data = fs.readFileSync('/resource.json'); // 同步 方法 


很 多 其 他 的 编程 语言 就 是 这 么 做 的 ， 也 就 是 大 家 常 说 的 “顺序 编程 ”或 “同步 编程 ”。 这 样 做 的 好 处 就 是 直观 ， 便 于 人 类 直线 思考 。 坏 处 就 是 ， 当 数据 ( 流 ) 很 大 时 ， 必 然 需 要 长 时 间 执 行 ， 直 接 阻塞 
进程 ， 整 个 程序 只 好 停 下 来 等 待 ， 这 就 是 MO 阻塞 。Nodejjs 因 为 用 了 回调 ，JavaScript 代 码 所 在 的 ( 主 ) 线程 会 把 一 切 回调 扔 给 后 台 的 线程 池 去 处 理 ， 而 自己 则 一 步 运行 到 底 ， 所 以 称 为 MO 非 阻塞 。 


4 进一步 扩 


弄 


既然 “ 事 寻 


法 ， 就 是 指 回调 谋 套 太 多 ， 流 程 复 杂 ， 难 以 驾驭 。 


不 过 , 社 


区 已 经 提供 了 多 种 解决 方案 ， 比 如 async、promise 等 流程 化 组 件 就 能 很 好 地 解决 这 个 问题 。 


(错误 ) 的 处 理 。 


8.3 ”异常 要 捕捉 


皆 回 调 ”， 那 么 回调 里 面 也 可 能 包含 回调 ， 事 实 上 这 种 情况 还 非常 多 。 这 也 是 很 多 人 对 Nodejjs 心 生 晤 惧 的 原因 之 一 ， 多 年 的 高 手 也 经 常会 栽 在 这 一 点 上 ， 于 是 大 家 总 结 有 “回调 大 坑 ” 的 说 


回调 太 多 、 异 常 难以 捕 气 ， 是 Nodejs 广 为 诉 病 的 地 方 。Node.,js 是 单 进 
常 很 难 定位 。 所 以 ， 很 多 人 说 ，Nodejs 很 快 ， 但 很 脆弱 。 有 利 就 有 浆 ， 这 就 是 真实 的 世界 。 


与 之 形成 鲜明 对 比 的 是 Ruby on Rails， 使 


1. 概 念 理解 


全 说 明 下 面 的 内 容 主要 学 习 并 引用 了 这 篇 文章 “Node js 错误 处 理 最 人 
笔者 个 人 受益 匪 浅 ， 在 此 感谢 该 文 原作 者 。 


程 的 应 用 ， 异 常 如 果 未 被 正确 处 理 ， 


体 细节 在 后 文 阅读 代码 时 再 详细 讲解 。 下 面 就 来 说 说 因为 回调 而 更 加 环 手 的 问题 一 一 程序 异常 


一 旦 抛 出 ， 就 会 使 得 整个 进程 死 掉 。 而 异常 多 发 生 在 回调 函数 里 ， 回 调 非常 复杂 的 时 候 ， 异 


ROR 的 小 伙伴 一 定 对 此 印象 深刻 : 任何 一 个 Error 发 生 ，RoR 抛 出 的 错误 信息 里 ， 都 会 明确 给 出 出 错 代码 的 位 置 ， 而 且 通 常 定位 都 非常 准确 。 


Ea 实践 (https://www.joyent.com/node-js/production/design/errors) ”， 并 对 内 容 做 了 简单 意译 和 适当 取舍 ， 通 过 这 篇 文章 的 学 习 ， 


异常 通常 分 为 两 种 类 型 : 一 类 是 失败 ， 即 正确 的 程序 在 运行 时 因为 其 他 
员 个 人 的 问题 ， 比 如 输 错 了 变量 名 、 方 法 名 ， 甚 至 存在 逻辑 错误 等 。 


素 所 导致 的 失败 ， 例 如 内 存 不 足 、 


网 络 不 通 、 远 程 服务 器 宕 机 等 ， 都 是 可 以 预期 的 ， 另 一 类 是 失误 ， 也 就 是 Bug， 通 常 是 程序 


本 节 所 讲 的 异常 处 理 ， 是 指 第 一 类 失败 的 情况 ， 能 够 让 正确 的 程序 在 任何 情况 下 永远 不 失败 ， 那 才 叫 健壮 。 而 对 于 另 一 类 失误 的 处 理 ， 即 对 Bug 的 处 理 ， 只 能 要 求 程序 员 个 人 加 强 修炼 ， 避 免 一 些 低级 


错误 ;对 于 一 些 深 


层次 的 逻辑 错误 ， 努 力 提高 调试 和 测试 水 平 ， 力 争 找到 问题 所 在 ; 或 者 发 挥 社 


2. 失 败类 型 
失败 的 原因 通常 是 客观 存在 的 ， 可 以 在 代码 里 得 到 有 效 处理 ， 例 如 系统 本 身 (内 存 不 足 或 打开 文件 数 过 多 ) 
连接 失败 ) 等 。 主 要 场景 具体 包括 如 下 几 种 。 


“ 连接 不 到 服务 器 。 


“ 无 法 解析 主机 名 。 


“ 无效 的 用 户 输入 。 


“ 请 求 超 


时 。 


' 服务 器 返回 500。 


“ 套 接 字 


“ 系统 内 


被 挂 起 。 


存 不 足 。 


失误 的 原 


多 为 


E 观 | 


“ 读 取 一 个 undefined 属 性 。 


“ 调用 异步 函数 没有 指定 回调 。 


素 ， 除 非 修正 错误 ， 和 否则 永远 无 法 被 有 效 地 处 理 。 主 要 场景 具体 包括 如 下 几 种 。 


“ 传递 了 错误 参数 : 应 该 传 对 象 的 时 候 传递 了 一 个 字符 囊 ， 或 者 其 他 内 容 等 。 


区 的 力量 ， 群 策 群 力 。 


、 系 统 配置 (没有 到 达 远 程 主机 的 路 由 ) 、 网 络 问题 (端口 挂 起 ) 、 远 程 服务 (500 错 误 ， 


3. 处 理 方法 


错误 处 理 并 不 能 被 赁 空 加 载 到 一 个 没有 任何 错误 处 理 的 程序 中 。 而 且 无 法 在 一 个 集中 的 地 方 处 理 所 有 的 异常 。 


可 能 产生 的 结果 。 包 括 为 什么 出 错 ， 


对 于 一 个 给 定 的 错误 ， 可 以 进行 如 下 这 些 操作 。 


1) 直接 处 理 。 有 的 时 候 我 们 很 清楚 


正在 维护 到 


以 及 错误 背后 的 原因 等 。 


2) 报告 给 客户 端 。 如 果 不 知道 怎么 处 理 这 个 
户 提交 了 不 正确 的 JSON, 由 


形 。 例 如 ， 


3) 重 试 操作 。 对 于 那些 来 自 网 络 和 远程 服务 的 错误 ， 有 的 


使 再 解析 一 次 也 是 无 用 的 。 


试 ， 那 么 应 该 用 文档 记录 下 将 


进行 多 次 重 


试 ， 重 试 了 多 少 次 直到 失败 ， 


户 端 调 
屋 都 没有 意识 到 下 层 


同时 也 在 尝试 。 


4) 直接 衣 演 。 对 于 那些 本 不 可 能 发 生 的 错误 ,或 者 由 于 程序 员 的 失误 所 导致 的 错误 (比如 无 法 连接 到 同一 程序 旦 
误 ， 是 JavaScript 这 样 的 脚本 语言 所 无 法 处 理 的 ， 直 接 崩 省 是 十 分 合理 的 做 法 。 即 使 在 child_process.exec 这 样 的 分 离 操 作 里 


， 而 那个 客户 端 又 被 另外 一 个 由 


者 没有 访问 配置 文件 的 权限 ， 无 计 可 施 的 时 候 ， 直 接骨 省 就 是 了 。 


5) 记录 错误 。 有 的 时 候 我 们 什么 都 做 不 了 ， 既 没有 操作 可 以 本 


时 候 只 需要 


量 试 操作 就 可 以 解决 问题 。 比 Et 


0， 远 程 服务 返回 了 503 (服务 不 可 | 


因此 需要 提前 考虑 任何 会 导致 失败 的 代码 (比如 打开 文件 、 连 接 服务 器 、Fork 子 进程 等 ) 


自己 应 该 做 什么 。 如 果 在 尝试 打开 日 志文 件 的 时 候 得 到 了 一 个 ENOENT 错 误 ， 很 有 可 能 是 第 一 次 打开 这 个 文件 ， 那 么 要 做 的 首先 就 是 创建 它 。 更 有 意思 的 是 ， 如 果 
多 器 (比如 数据 库 ) 的 持久 连接 ， 遇 到 了 一 个 “socket hang-up” 的 异常 ， 这 通常 意味 着 远 端 或 本 地 的 网 络 连 接 失 败 了 ， 大 多 数 时 候 这 种 错误 只 是 暂时 的 ， 那 么 重新 连接 就 


能 解决 问题 。 


常 ， 那 么 最 简单 的 方式 就 是 放弃 正在 执行 的 操作 ， 清 理 所 有 已 经 执行 了 的 操作 ， 然 后 把 错误 传递 给 客户 端 。 这 种 方式 适合 于 在 短 时 间 内 无 法 解决 错误 的 情 


错误 ) ， 可 能 在 几 秒 钟 之 后 再 重 试 又 可 以 了 。 如 果 确 定 要 重 


以 及 两 次 重 试 之 间 的 时 间 间 隔 。 另 外 ， 不 要 每 次 都 假设 通过 重 试 来 解决 问题 。 如 果 操 作 位 于 栈 中 很 深 的 地 方 〈 比 如 ， 操 作 被 一 个 客 


户 操作 的 客户 端 所 控制 ) ， 那 么 在 这 种 情形 下 ， 快 速 失败 让 


户 去 重 试 会 更 好 。 如 果 栈 中 的 每 一 


有 的 本 地 套 接 字 ) ， 可 以 记录 一 个 错误 日 志 然 


情 都 觉得 需要 重 试 ， 那 么 


户 最 终 会 等 待 更 长 的 时 间 ， 


因为 每 一 


后 直接 崩溃 。 其 他 的 比如 内 存 不 足 之 类 的 错 


得 到 ENOMEM 错 误 ， 也 应 该 考虑 直 


了 。 除 了 记录 一 条 日 志 并 且 继续 使 


4 编码 实践 


(1) 错误 的 编码 方式 


试 或 放弃 ， 又 没有 任何 理由 直接 崩溃 应 


剩 下 的 服务 以 外 ， 我 们 什么 都 做 不 了 。 


如 下 的 代码 是 不 能 正确 处 理 异常 的 。 如 果 不 明白 为 什么 会 这 样 ， 请 各 


function myApiFunc (callback) 
{ 

// 这 种 模式 并 不 工作 

te 


新 温习 一 下 8.2 节 的 


// 异步 的 原因 ， 这 里 的 回调 函数 被 放 在 另 一 个 线程 中 独立 工作 ， 并 不 在 try/catch 下 工作 


doSomeAsynchronousOperation (function (err) 


if (err){ 


throw (err); 


// continue as normal 


} 


]); 
} catch (ex) { 
callback (ex); 


程序 ， 这 时 就 要 记录 下 错误 。 举 个 例子 ， 


调 部 分 ， 记 住 “ 事 事 皆 


一 个 异常 ， 就 会 被 多 


try/catch 和 异步 函数 不 是 这 样 工作 的 。 回 忆 一 下 ， 回 调 (异步 ) 


数 的 外 面 ， 并 没有 try 的 代码 块 在 作 


。 如 果 采 


(2) 怎么 传递 错误 


Node.js 提 供 了 3 种 基本 的 传递 模式 ， 分 别 是 throw、callback 和 eventEmitter， 它 们 的 区 别 


冰 数 的 意义 就 在 于 被 调 


惯 了 其 他 语言 进行 同步 编程 ， 那 么 一 开始 很 容易 就 会 这 样 写 代码 。 从 直观 上 理解 ， 上 面 的 代码 是 想 要 在 出 现 异步 错误 的 时 候 调 
自己 的 回调 函数 (传递 给 doSomeAsynchronousOperation 的 函数 ) 里 抛 


面 的 catch 代 码 块 捕获 到 。 


接骨 省。 在 


光 了 所 有 的 文件 描述 符 ， 或 


DNS 跟踪 了 一 组 远程 服务 ， 结 果 有 一 个 DNS 失败 


callback， 并 把 错误 作为 参数 进行 传递 。 这 样 做 是 因为 误 以 为 在 


的 时 候 myApiFunc 函 数 已 经 执行 了 ( 非 阻 塞 ) ， 这 也 意味 着 try 代 码 块 已 经 退出 了 。 也 就 是 说 ， 在 这 个 回调 函 


这 个 模式 ， 那 么 结果 就 是 在 抛 出 异常 的 时 候 ， 程 序 就 崩溃 了 。 


体 如 下 。 


“thtow 是 以 同步 的 方式 传递 异常 的 ， 也 就 是 说 ，throw 与 要 使 用 throw 传 递 错误 的 函数 拥有 相同 的 上 下 文 环 境 。 如 果 调 用 者 (或 者 调用 者 的 调用 者 ) 使 用 了 tty/catch， 则 可 以 捕获 异常 。 如 果 所 有 的 调用 者 


都 没有 使 用 try/catch， 那 么 通常 情况 下 ， 程 序 会 角 演 


(异常 也 可 能 会 被 domain 或 进程 级 的 uncaughtException 横 捉 到 ， 详 见 下 文 ) 。 


“ callback 是 最 基础 的 异步 传递 事件 的 一 种 方式 。 用 户 传 进来 一 个 函数 callback) ， 之 后 当 菜 个 异步 操作 完成 后 调用 这 个 callback。 通 常 callback 会 以 callback (err，result) 的 形式 被 调用 ， 这 种 情况 下 ，err 
和 tesult 必 然 有 一 个 是 非 空 的 ， 这 一 点 将 取决 于 操作 是 成 功 还 是 失败 。 


:更 复杂 的 情形 是 ， 函 数 没有 用 callback 而 是 返回 一 个 eventEmitter 对 象 ， 调 用 者 需要 监听 这 个 对 象 的 error 事 件 。 在 如 下 两 征 


一 种 情况 是 : 当 在 进行 一 个 可 能 会 


了 一 个 eventEmitter， 


子 里 , 没有 用 callback， 而 是 返回 
3 一 种 情况 是 : 用 在 那些 具有 
发 “connect” “end” “timeout” 


很 重要 ， 同 时 被 外 


(3) 怎样 使 用 它们 


通 
里 说 明 清楚 。 


(4 


客观 上 ， 失 败 可 以 被 显 式 的 机 所 


发 的 还 有 什么 事件 (例如 “close”) 、 角 


domain 和 process.on (uncaughtException ) 


产生 多 个 错误 或 多 个 结果 的 复杂 操作 的 时 候 。 
每 个 结果 都 会 触发 一 个 row 避 


杂 状 态 机 的 对 象 上 ， 这 些 对 象 往往 伴随 着 大 量 的 异步 
“drain” “close” 事件 。 这 样 ， 和 


其 实 ，callback 和 eventEmitter 可 以 归 为 一 类 ， 不 要 同时 使 用 它们 。 


还 是 不 用 ? 


所 处 理 。domain 及 进程 级 别 的 uncaughtException 这 两 种 方式 一 般 情 况 下 不 鼓励 使 


预料 到 的 程序 错误 中 恢复 ， 而 不 是 


在 具体 的 编码 过 程 中 。 


的 准则 是 : 既 可 以 同步 传递 错误 ( 抛 出 ) ， 又 可 以 异步 传递 错误 ( 传 给 一 个 回调 函数 或 触发 eventEmitter 的 error 事 件 ) ， 但 不 要 同时 使 用 。 


情况 下 ， 这 种 方式 很 有 用 。 


事件。 例如 ， 一 个 套 接 字 是 一 个 eventEmitter， 那 么 它 可 能 会 触 
恨 自然 地 就 把 “error” 作 为 另外 一 种 可 以 被 触发 的 对 
册 发 的 顺序 还 有 套 接 字 是 否 在 结束 的 时 候 处 于 关闭 状态 。 


比如 ， 有 一 个 请 求 一 边 从 数据 库 读 取 数 据 一 边 把 数据 发 送 回 客户 端 ， 而 不 是 等 待 所 有 的 结果 一 起 到 达 再 发 送 。 在 这 个 例 
件 ， 当 所 有 结果 发 送 完毕 后 会 触发 end 事 件 ， 出 现 错误 时 会 触发 一 个 error 事 件 。 


件 。 在 这 种 情况 下 ， 能 够 清楚 地 知道 “error” 还 有 其 他 事件 何 时 被 触发 这 一 点 


哪 一 个 取决 


异常 是 怎么 传递 的 ， 这 点 得 在 文档 


。 其 实 ， 它 们 通常 是 作为 一 种 保障 机 制 ， 被 


在 整个 应 


于 从 未 能 


级 别 ， 主 要 


5. 代 码 示例 


下 面 的 函数 会 异步 地 连接 到 一 个 |Pv4 地 址 的 TCP 端 口 : 


六 和 并 并 并 并 并 并 并 并 并 并 条 并 并 条 和 江 和 条 半 并 半 并 先 愉 


x 


四 


Make a TCP connection to the given IPv4 address. Arguments: 


ip4addr a string representing a valid IPv4 address 
tcpPort a positive integer representing a valid TCP port 
timeout a positive integer denoting the number of milliseconds 


to wait for a response from the remote server before 
considering the connection to have failed. 


callback invoked when the connection succeeds or fails. Upon 
success, callback is invoked as callback (null, socket), 
where 'socket' is a Node net.Socket object. Upon failure, 
callback is invoked as callback (err) instead. 


This function may fail for several reasons: 


SystemError For "connection refused" and "host unreachable" and other 
errors returned by the connect (2) system call. For these 
errors, err.errno will be set to the actual errno symbolic 


name. 


TimeoutError Fmitted if "timeout" milliseconds elapse without 
successfully completing the connection. 


* All errors will have the conventional "remoteIp" and "remotePort" properties. 
* After any error, any socket that was created will be closed. 


x 


/ 


function connect (ip4addr, tcpPort, timeout, callback) 


{ 


assert .equal (typeof (ip4addr), 'string',"argument "ip4adqr' must be a string"); 
assert .ok (net.isIPv4 (ip4addr),"argument ‘ip4addr' must be a valid IPv4 address"); 
assert .equal (typeof (tcpPort), ‘'number',"argument 'tcpPort' must be a number"); 


assert.ok(!isNaN (tcpPort) &&LcPPort> 0 &&tcpPort< 


assert.equal (typeof (timeout), 'number',"argument 'timeout' must be a number"); 
assert.ok(!isNaN(timeout) && timeout > 0,"argument 'timeout' must be a positive 
integer"); 
assert.equal (typeof (callback), 'function'); 


/* do work */ 


这 个 例子 很 简单 ， 但 很 好 地 展示 了 上 面 所 讨论 的 一 些 建议 。 


“ 参数 、 类 型 及 其 他 一 些 约束 被 清晰 地 文档 化 。 


“ 该 函数 对 于 所 接受 的 参数 是 非常 严格 的 ， 并 且 会 在 得 到 错误 参数 的 时 候 抛 出 异常 (程序 员 的 失误 ) 。 


: 该 函数 记录 了 可 能 出 现 的 失败 集合 。 通 过 不 同 的 “name” 值 可 以 区 分 不 同 的 异常 ， 而 “errno” 则 用 来 获得 系统 错误 的 详细 信息 。 


“ 该 函数 记录 了 传递 异常 的 方式 (通过 失败 时 调用 回调 函数 来 记录 ) 。 


: 返回 的 错误 有 “remoteIp” 和 “remotePort” 字 段 ， 这 样 用 户 就 可 以 定义 自己 的 错误 了 (比如 ， 一 个 HTTP 客 户 端的 端口 号 是 隐 含 的 ) 。 


里 


np 


6.Error 对 象 属性 命名 约定 


强烈 建议 在 发 生 错误 的 时 候 ， 
息 ， 既 从 编程 上 ， 也 从 自 定义 的 错误 消息 上 。 


虽然 很 明显 ， 但 是 清晰 地 记录 了 连接 失败 后 的 状态 : 所 有 被 打开 的 套 接 字 此 时 已 经 被 关闭 了 。 


65536, "argument 'tcpPort' must be a positive integer between 1 and 65535"); 


如 下 这 些 名 字 来 保持 和 Nodejs 核 心 及 Nodejs 插 件 的 一 致 。 这 些 名 字 中 的 大 部 分 不 会 与 某 个 给 定 的 异常 相对 应 ， 但 是 在 出 现 疑 问 的 时 候 ， 应 该 包含 看 起 来 有 用 的 任何 信 


localHostname、localIp、localPort、remoteHostname、remoteIp、remotePort、 path、srcpath、vdstpath、hostname、ip、propertyName、propertyValue、syscall、errno 


8.4 


第 9 章 先 简 和 


8.5 


本 章 所 讨论 的 内 容 ， 不 仅 包含 了 初学 者 经 常会 感到 困 


限于 篇 


总 结 


/GAN= 口 


至 此 ， 第 二 部 分 已 经 完结 ， 该 部 分 共 包含 4 章 ， 考 查 了 币 圈 Nodejs 的 应 用 情况 ， 简 单 介绍 了 Nodejjs 的 入 门 知识 ， 为 研究 学 习 Nodejs 应 


参考 


介绍 亿 书 ， 然 后 从 整体 上 分 析 它 的 功能 模块 布局 。 


可 


《Nodejjs 中 流 (stream) 的 理解 》: http://segmentfault.com/a/1190000000519006 


《Linux 管 道 PIPE 的 原理 和 应 F 


》: https://www.hitoy.org/pipe-aplication-in-linux.html 


《在 单线 程 的 情况 下 ，Node.js 是 如 何 分 发 子 任务 去 执行 的 ? 》: http://www.zhihu.com/question/24780826 


《Node is Not Single Threaded》: http://rickgaribay.net/archive/2012/01/28/node-is-not-single-threaded.aspx 


《Node.js 错 误 处 理 最 佳 实践 》: https://www.joyent.com/node-js/production/design/errors 


《Node.js 异 步 异 常 的 处 理 与 domain 模 块 解析 》: https://cNode.js.org/topic/516b64596d38-277306407936 


惑 的 地 方 ， 也 包含 了 很 多 高 手 不 小 心 就 会 掉 进 的 陷阱 。 理 解 了 流 ， 有 效 解决 了 回调 和 异常 ， 编 写 Nodejs 程 序 就 是 一 个 简单 且 轻 松 的 过 程 。 


避 ， 本 章 没有 具体 讨论 async、domain 等 非常 具体 的 解决 方案 ， 这 些 内 容 将 放 在 后 面 的 章节 里 详细 说 明 。8.5 节 里 有 几 篇 很 好 的 参考 文章 ， 有 兴趣 的 读者 请 自行 查阅 。 


商定 了 基础 。 接 下 来 将 正式 进入 第 三 部 分 “源码 解读 ”阶段 ， 


三 部 分 “源码 解读 


我 们 的 最 终 目标 是 使 用 Node.js 开 发 一 款 像 比 特 币 一 样 的 区 块 链 产品 。 很 显然 ， 在 开始 之 前 ， 如 果 有 现成 的 经 验 可 以 用 来 学 习 和 借鉴 ， 就 不 用 再 去 “重复 制造 轮子 ”了 ， 这 是 目前 开发 领域 的 一 个 重要 共 


识 。 


站 在 巨人 的 肩 上 ， 一 方面 可 以 快速 了 解 Node.js 技 术 知 识 ， 另 一 方面 可 以 对 区 块 链 有 一 个 更 加 深刻 的 学 习 和 理解 ， 一 举 两 得 。 第 三 部 分 将 会 学 习 和 开发 一 款 这 样 的 加 密 货 币 产品 ， 具 体 方法 是 掌握 代码 的 
功能 ， 理 清 代码 的 运作 流程 。 通 常会 提供 详细 的 UML 类 图 来 说 明 。 


源码 地 址 具体 如 下 。 
网 址 : https://github.com/Ebookcoin/ebookcoin.git 


版 本 : v0.1.3 


第 9 章 ” 亿 书 , 一 个 面向 未 来 的 自 出 版 平台 


本 章 将 通过 一 个 产品 的 发 行 说 明 (白皮书 ) ， 来 了 解 产 品 最 初 的 设计 需求 。 无 论 是 代码 设计 还 是 源码 分 析 ， 我 们 都 要 根据 这 些 需求 逐渐 深入 代码 的 内 部 ， 这 样 的 思路 能 够 帮助 我 们 更 加 轻松 、 快 速 地 掌 
握 代码 的 精 参 。 


9.1 伺 书 是 什么 


官方 定义 (白皮书 v2.02016.5.1) 如 下 。 


亿 书 ， 其 英文 名 字 Ebookchain， 是 一 款 写 作 软 件 ， 基 于 区 块 链 技 术 ， 具 备 版 权 保护 、 协 同 创作 、 一 键 发 布 等 功能 ， 将 促进 人 们 更 加 主动 地 积累 知识 、 分 享 经 验 ， 为 人 类 创作 注入 新 动力 。 


亿 书 的 核心 目标 是 通过 提供 写作 工具 ， 为 知识 创作 和 积累 注入 新 动力 ， 进 而 建立 覆盖 全 人 类 的 P2P 网 络 ， 打 造 包括 电子 商务 在 内 的 融合 社会 化 、 信 息 化 、 商 业 化 、 物 联 网 的 全 新 网 络 ， 将 人 类 带 入 价值 
传播 的 新 时 代 。 


9.2 使 用 场景 


对 于 普通 人 而 言 ， 亿 书 与 日 常 使 用 的 办 公 软 件 (Word、WPS 等 ) 相似 ， 就 是 一 款 简单 的 文字 写作 工具 ， 具 备 安装 简单 、 编 辑 可 视 、 互 动 协作 等 功能 ， 还 可 以 直接 获得 海量 、 专 业 、 系 统 的 电子 | 


网 
击 
污 


源 。 


对 于 博客 爱好 者 ， 它 可 以 安装 在 服务 器 端 ， 提 供 公开 访问 的 功能 ， 大 大 简化 了 博客 安装 、 个 性 化 与 维护 的 难度 。 对 于 专业 作者 ， 它 的 电子 书 编辑 、 一 键 发 布 、 版 权 保护 与 交易 等 自 出 版 功能 ， 具 备 了 强 
大 的 吸引 力 。 


对 于 出 版 社 等 企业 用 户 和 第 三 方 开发 者 ， 它 提供 了 侧 链 功能 ， 可 以 基于 亿 书 强 大 的 网 络 和 市 场 ， 使 用 亿 书 侧 链 、 智 能 合约 、 云 存储 和 计算 节点 ， 构 建 、 发 布 个 性 化 的 去 中 心 化 软件 ， 货 币 化 一 切 有 形 或 
无 形 的 资产 ， 并 从 中 盈利 。 


对 于 读者 、 作 者 和 开发 者 而 言 ， 亿 书 就 是 读者 的 知识 宝库 ， 作 者 的 一 站 式 解决 方案 ， 开 发 者 的 


古 


大 市 场 ， 是 一 个 以 区 块 链 技术 驱动 的 相互 促进 、 互 为 所 用 、 共 享 共 赢 的 生态 系统 。 


9.3 ”主要 特点 


“ 用 户 可 以 用 来 撰写 博客 文章 ， 将 博客 轻松 整理 成 电子 书 ， 并 一 键 发 布 。 

“ 用 户 能 轻松 地 将 其 安装 在 服务 器 上 ， 绑 定 自己 的 域名 ， 定 制 个 性 化 页 面 ， 以 供 全 世界 浏览 ， 轻 松 搭建 自 出 版 平台 ， 取 代 市 场 上 的 各 类 博客 平台 。 
“ 用 户 能 够 很 方便 地 与 他 人 合作 ， 类 似 Github 的 代码 托管 ， 可 以 多 分 支 处 理 ， 后 台 给 出 多 维度 统计 ， 方 便利 益 分 配 。 

:产品 的 背后 ， 由 加 密 货 币 亿 书 币 〈Ebookcoin) 驱动 ， 为 文章 、 电 子 书 、 视 频 、 图 片 自动 追加 版 权 保 护 和 认证 ， 从 而 保护 用 户 权益 。 

“ 基于 区 块 链 ， 提 供 文章 、 多 媒体 、 电 子 书 的 透明 交易 ， 收 益 分 配 管理 等 功能 。 

:为 传统 的 出 版 机 构 、 媒 体 等 企业 ， 提 供 侧 链 功能 ， 帮 助 他 们 实现 基于 区 块 链 的 版 权 保护 和 流程 改造 功能 。 


“ 优化 开发 接口 ， 方 便 传 统 博客 、 论 坛 等 知识 分 享 软件 的 集成 使 用 ， 以 更 加 宽容 开放 的 心态 ， 吸 引 第 三 方 开发 者 ， 开 发 出 电子 商务 、 物 联网 、 新 闻 网 站 、 社 交 媒 体 等 各 类 应 用 。 


9.4 核心 功能 


亿 书 的 核心 功能 具体 如 下 。 


“ 高 性 能 对 等 网 络 。 


“去 中 心 化 的 存储 和 计算 。 

“ 易 用 易 扩 展 的 可 编程 侧 链 。 

“ 简单 易 用 的 可 视 化 编辑 器 。 

“去 中 心 化 博客 。 

“ 自 出 版 平台 。 

“版权 注册 、 签 名 与 验证 。 

“ 针对 主流 开源 产品 的 官方 插件 。 


“ 面向 第 三 方 开发 者 的 开发 工具 包 SDK。 


9.5 ”技术 架构 


亿 书 完全 基于 Node.js 平 台 研 发 ， 后 台 使 用 Express.js 框 架 ， 前 端 使 用 Ember.js 框 架 ， 客 户 端 使 用 Electron 框 架 ,数据 库 使 用 SQLite， 前 后 端 统一 使 用 JavaScript 脚 本 语言 ， 界 面 使 用 HTML5 和 CSS3。 


亿 书 ,使 用 建立 在 HTTP 协 议 之 上 的 点 对 点 网 络 ， 基 于 DPoS (授权 股权 证 明 机 制 ) 共识 算法 ， 无 须 “ 挖 矿 ”， 大 约 1 亿 枚 币 子 。 每 个 块 的 时 间 为 10 秒 ， 每 个 周期 的 101 个 区 块 均 由 101 个 代表 随机 生成 ， 
广播 并 添加 到 区 块 链 里 ， 在 得 到 6 ~ 10 个 确认 后 交易 完成 ， 一 个 完整 的 101 个 块 的 周期 大 概 需要 16 分 钟 。 


亿 书 数据 库 表 格 及 其 关联 关系 模型 如 图 9-1 所 示 。 
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address: VARCHAR © accountid String 

© transactionld: VARCHAR FOREIGN KEY [2 © dependentid: String 


Tt 
© transactionld: VARCHAR FOREIGN KEY 
Ee 


、 


previousBlock /blockd 


@ rem accounts2u contacts L 
:1 accountid * 
© accountld: String = © accountld: String 
O dependentld String 让 © dependentld: String 


transactionld /transactionld WansactionId 
1 


[nm | 
© transactionld: VARCHAR FOREIGN KEY © username: VARCHAR © votes: TEXT © username; VARCHAR © appld: VARCHAR ri © accountld: String 
© publickey: BINARY © transactionld: VARCHAR FOREIGN KEY © transactionld: VARCHAR FOREIGN KEY © transactionld: VARCHAR FOREIGN KEY © transactionld: VARCHAR FOREIGN KEY Pir © dependentld: String 


图 9-1 亿 书 数据 库 表 格 及 其 关联 关系 模型 


从 开发 的 代码 上 看 ， 它 以 Express 作 为 开发 框架 ， 各 功能 模块 都 放 在 modules 文 件 夹 里 ， 结 构 简单 、 清 晰 。 


9.6 总 结 


/EN= 口 


本 章 主 要 是 对 亿 书 做 一 个 概览 ， 目 的 是 了 解 我 们 接 下 来 要 分 享 的 产品 是 什么 。 同 时 也 说 明 一 下 该 应 用 的 价值 : 既 可 以 学 习 区 块 链 技术 的 开发 ， 也 可 以 对 Nodejs 开 发 平台 有 所 了 解 。 亿 书 是 目前 覆盖 
链 技术 多 个 方面 的 应 用 之 一 。 


[a 


9.7 参考 


《 亿 书 白皮书 v2.0》: http://ebookchain.org/ebookchain.pdf 


亿 书 官方 网 站 : http://ebookchain.org 


第 10 章 ”入 口 程序 appjs 解 读 


第 二 部 分 曾 提 到 过 ，Nodejs 的 应 用 最 终 都 可 以 合并 成 一 个 文件 ， 是 为 了 开发 和 维护 方便 ， 才 将 其 拆 分 成 多 个 文件 的 。 被 拆 分 的 那个 文件 自然 是 我 们 重点 研究 的 对 象 ， 这 个 文件 通常 是 appjs 或 
serverjs， 一 般 称 为 入 口 程序 。 显 然 ， 亿 书 用 的 就 是 app.js。 本 章 就 来 阅读 一 下 该 文件 ， 学 习 并 研究 它 的 整体 架构 流程 。 


10.1 源码 与 类 图 
1. 源 码 


本 章 所 涉及 的 主要 源码 地 址 具体 如 下 。 


https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/app.js 


2. 类 图 


Javascript 原 本 无 类 ， 因 此 它 的 类 图 并 不 好 处 理 ， 这 里 只 能 大 致 给 出 appjs 与 其 他 模块 的 关联 关系 ， 如 


网 


10-1 所 示 。 


10.2 解读 
请 先 直 接 读 一 遍 源 代码 ， 然 后 再 来 阅读 下 面 的 解析 。 


10.2.1 配置 处 理 


任何 一 个 应 用 都 会 提供 一 些 参数 。 对 这 些 参数 的 处 理 有 很 多 种 方案 ， 但 通常 会 提供 一 种 理想 环境 ， 即 默认 配置 ， 同 时 提供 一 种 方法 可 以 让 用 户 自行 修改 。 
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ul 1 1 
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aScript Require» 
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1 
1 
1 
1 
1 
1 
<Requirey Nn | «Requite»l 
«JavaScript Require» 过 ST ul «Require»! 
-/helpers/zscheme-express.js «JavaScript Require» le - - - -- I I 前 
hn <Requirel | Regu " 
«Requirem ft Require» | ge 
Wl 1 1. 
i 1 <ReqHirqm 
! <Requireoh 1! 
«JavaScript Require» ' n 
fs 1 1 


«JavaScript Requirew |'! 
四 Bequest ee 
四 


«JavaScript Require» 
Es «JavaScript Require» 
randomstring 


10-1 亿 书 入 口 程序 app.js 类 


1. 全 局 默认 配置 


默认 参数 较 少时 ， 通 常 可 以 将 全 局 默认 配置 硬 编码 到 代码 里 。 不 过 还 有 一 种 更 灵活 的 方式 ， 那 就 是 使 用 单独 文件 。 这 里 就 是 使 用 文件 ./configjson 来 保存 全 局 配置 的 ， 代 码 如 下 : 


{ 

"port": 7000, 

"address": "0.0.0.0", 
"serveHttpAPI": true, 
"serveHttpWallet": true, 


erelonns O02lelt 
"fileLogLevel": "info", 
"consoleLogLevel": "log", 


"sharePort": true, 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


使 用 时 只 需要 require 就 可 以 了 ， 源 码 如 下 : 


var appConfig = require("./config.json"); // app.js 4 行 


不 过 ， 为 了 提高 灵活 性 ， 默 认 值 通常 允许 用 户 自行 修改 。 


2. 使 用 commander 组 件 ， 引 入 命令 行 选项 


commander 是 Nodejjs 的 第 三 方 组 件 (使 用 npm 安 装 ) ， 常 被 用 来 开发 命令 行 工具 ， 用 法 极为 简单 ， 源 码 如 下 : 


// 1 行 
Var program = require('commander'); 


// 19 行 

program 
.version (packageJson.version) 
.option('-~c, --config <path>', "Config file path') 
.option('-p, --port <port>', 'Listening port number') 


.option('-~a, --address <ip>', 'Listening host name or ip') 
.option('-~b, --blockchain <path>', 'Blockchain db path') 
‘option('-x, --peers [peershttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/...]', 'Peers list') 


.option('-l, --log <level>', 'Log level') 
.Parse (process .argv); 


这 样 ， 就 可 以 在 命令 行 执行 命 令 时 ， 加 带 -c、-p 等 选项 ,例如 : 


node app.js -p 8888 


这 时 ， 该 选项 就 以 program.port 的 形式 被 保存 起 来 ， 可 以 手动 修改 一 下 : 


// 39 行 
if (program.port) { 
appConfig.port = program.port; 


这 是 处 理 Nodejs 应 用 全 局 配置 的 一 种 常用 且 简 单 的 方式 ， 值 得 学 习 。 更 多 内 容 建议 阅读 第 四 部 分 第 20 章 “命令 行 开发 介绍 ”， 对 commander 组 件 进行 深入 学 习 。 


10.2.2 异常 捕捉 


我 们 在 8.3 节 特意 提 到 过 要 捕捉 异常 ， 在 这 里 我 们 很 轻松 就 可 以 看 出 来 ， 代 码 对 全 局 异常 的 处 理 方式 。 


全 注意 “对 于 qomain 模 块 ， 现 在 已 经 不 提倡 使 用 了 ， 在 后 续 的 更 新 中 将 会 去 除 这 部 分 代码 ， 这 里 仅 做 了 解 即 可 。 


(1) 使 用 uncaughtException 捕 捉 进 程 异常 


相关 代码 如 下 : 


// 65 行 

process.on('uncaughtException', function (err) { 
// 安全 地 处 理 进程 级 错误 
logger.fatal ('System error', { message: err.message, stack: err.stack }); 
process.emit ('cleanup'); 

js 


(2) 使 用 domain 模 块 捕获 全 局 异常 


// 96 行 
Var d = require('domain') .Create (); 
d.on('error', function (err) { 
logger.fatal ('Domain master', { message: err.message, stack: err.stack }); 
process.exit (0); 
])3 
d.runl(function () { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


另外 ， 对 各 个 模块 也 使 用 了 domain: 


// 415 行 
var d = require('domain') .create (); 


d.on('error', function (err) { 
scope.logger.fatal('domain ' + name, {message: err.message, stack: err.stack}); 
}); 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


10.2.3 ”模块 加 载 


这 才 是 真正 的 重点 ， 不 过 看 过 代码 之 后 ， 你 会 发 现 一 切 都 是 那么 干净 利落 ， 也 没有 多 层 回调 ， 原 来 是 用 了 async 流 程 管理 组 件 。 


整体 使 用 了 async.auto 进 行 顺序 调用 ;在 加 载 模块 时 ， 又 使 用 async.parallel， 使 其 并 行 运作 ; 在 发 生 错误 上 时， 使 用 async.eachSeries 对 已 经 加 载 处 理 的 数据 进行 回收 清 


哆 


， 说 明了 从 源码 的 第 103~438 行 代码 之 间 ， 各 模块 的 加 载运 行 顺序 。 


图 10-2 是 手工 绘制 的 使 用 async 加 载 模块 关系 


即 可 ， 不 用 太 在 意 async 的 用 法 。 下 面 就 来 解读 相关 源码 。 


区 


第 21 章 对 async 组 件 进行 了 详细 梳理 。 本 章 只 需要 理解 代码 的 意 


1. 初 始 网 络 


了 Express 框 架 。 前 文 提 到 过 ， 该 框架 必须 在 入 口 程序 里 进行 初始 化 操作 。 那 么 ， 具 体 应 该 如 何 调用 呢 ? 看 看 下 面 的 代码 ， 大 家 应 该 已 经 很 熟悉 了 。 


从 packagesjson 里 可 以 看 到 系统 使 用 


accounts , transactions , blocks , signatures ， 
transport , loader , System ，peer , delegates 
round , contacts , multisignatures , dapps 


sia , crypto , sql 


2016.02.19 @im 
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10-2 ”使 用 async 加 载 模块 关系 


注 : 从 上 到 下 为 顺序 执行 ， 箭 头 表示 依赖 调用 
白皮书 才 会 宣扬 亿 书 是 基于 HTTP 的 。 初 始 化 网 络 的 代码 如 下 : 


Express 是 Nodejs 重 要 的 Web 开 发 框架 ， 下 面 代码 中 的 网 络 (network) 本 质 上 就 是 以 Express 为 基础 的 Web 应 用 ， 正 因为 如 此 


// 215 行 
network: ['config', function (cb, scope) { 
Var express = require('express'); 
Var app = express (); 
Var server = require('http') .createServer (app) ; 
Var io = require('socket.io') (server); 


if (scope.config.ssl.enabled) { 
Var privateKey = fs.readFileSync (scope.config.ssl .options.key); 
Var certificate = fs.readFileSync (scope.config.ssl.options.cert); 


Var https = require('https') .createServer ({ 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


这 是 async.auto 的 基本 用 法 ，network 方 法 的 执行 依赖 于 config 方 法 (这 里 未 粘贴 代码 ) 的 执行 ，config 方 法 执行 的 结果 都 放 在 这 个 数组 scope.config 里 。 


这 里 的 代码 仅仅 只 是 初始 化 网 络 服务 ， 并 没有 做 太 多 实质 性 的 事情 ， 真 正 的 动作 在 下 面 。 


2 .构建 链接 
从 下 面 的 代码 开始 ， 我 们 将 会 看 到 这 个 应 用 的 本 质 。 源 码 中 的 第 270 行 代码 用 到 了 network 等 模块 ， 源 码 截取 如 下 : 
// 270 行 
connect: ['config', 'public', 'genesisblock', 'logger', 'build', 'network', function (cb, scope) { 


接着 ,下 面 的 代码 中 加 载 了 几 个 中 间 件 ， 表 示 该 应 


接受 ejs 模 板 驱动 的 HTML 文 件 ， 并 


视 


天 交 打 行 

scope.network. 
scope.network. 
scope.network.app 


.engine('html', require('ejs') .renderFile); 
.use (require('express-domain-middleware')); 
.Set ('view engine', 'ejs'); 
scope.network.app.set ('views', path.join( dirname, 'public')):; 
scope.network.app.use (scope.network.express.static (path.join( 


app 
app 


dirname, 


‘public'))): 


图 文件 、 图 片 和 样式 等 静态 文件 都 放 在 public 文 件 夹 中 。 这 些 信息 比 官方 文档 还 有 用 。 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/.. 


的 过 滤 等 ， 最 


接 下 来 就 是 对 请 求 参数 和 响应 数据 的 处 理 ， 包 括 对 节点 列表 peers 中 黑 名 单 、 白 名 


后 启动 服务 操作 : 


/7 


scope.network.server.listen (scope.config.port, scope.config.address, function (err) { 


3 .加载 逻辑 


通过 查看 代码 可 以 得 知 ， 亿 书 的 核心 逻辑 功能 是 账户 管理 、 交 易 和 区 块 链 。 这 些 模块 本 质 上 是 对 数据 库 操作 的 封装 ，account 与 modules/accounts 模 块 相对 应 ，transaction 与 modules/transactions 


模块 相对 应 ，block 与 modules/blocks 模 块 相对 应 ,我 们 会 在 介绍 相关 模块 时 再 进行 详细 分 析 。 


/7 3 抹 


logic: ['dbLite', 'bus', 'scheme', 'genesisblock', function (cb，scope) { 


// 嵌 套 了 async.auto 
async.auto({ 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


account: ["dbLite", "bus", 
new Account (scope, cb); 

}], 

transaction: ["dbLite", "bus", 
new Transaction (scope, cb):; 

}], 

block: ["dbLite", "bus", 
new Block (scope, cb) ; 


"scheme", 'genesisblock', function (ch, scope) 


"scheme", 'genesisblock', "account", 


"scheme", 'genesisblock', "account", 


}] 
} cb) 


{ 


function (ch, scope) 


t 


"transaction", function (ch, scope) { 


http: / /waw. hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/.. 


4. 加 载 模块 


上 面 所 有 代码 的 执行 结果 ， 都 要 与 这 里 的 各 个 模块 进行 共享 。 下 面 的 代码 说 明 各 个 模块 都 采 


// 411 行 
modules: ['network', 'connect', 'config', 
// 对 每 个 模块 都 使 用 'domain' 监 控 其 错误 
Object .keys (config.modules) .forEach (function (name) { 
tasks [name] = function (cb) { 
Var d = require('domain') .create (); 
d.on('error', function (err) { 


'logger', 'bus', 'sequence', 


'dbSequence', 


了 一 致 (不 一 定 完 


'balancesSequence', 


全 一 样 ) 的 参数 和 处 理 方法 ， 这 样 处 理 起 来 简单 又 方便 : 


'dbLite', ‘logic', function (cb, scope) { 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
ys 


Q.run (function () { 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


]); 
} 
]); 


// 让 各 个 模块 并 行 运行 
async.parallel (tasks, function (err, results) { 


cblerr, results); 


]); 


既然 这 里 的 模块 都 是 并 行 处 理 的 ， 研 究 


分 先后 了 。 


它们 就 不 需 


总 结 


VGN= 口 


10.3 


本 章 虽 然 已 经 开始 深入 代码 进行 


代码 中 还 有 很 多 细节 ， 本 章 并 没有 逐 行进 行 详细 介 


讲解 ， 但 是 仍然 较为 粗略 。 不 过 ， 通 过 本 章 的 讲解 ， 我 们 对 整个 应 


的 基本 架构 已 经 了 然 于 胸 。 若 要 继续 深入 


。 笔 者 个 人 认为 ， 读 代码 就 像 看 文章 ， 先 概览 一 遍 ， 然 后 再 逐步 深入 ， 不 一 定 一 开始 就 逐 


， 方 向 路 线 也 已 然 清 晰 。 


对 于 appjs 文 件 ， 熟 练 的 开发 者 阅读 它 可 能 只 需要 数 分 钟 即 可 ， 但 是 摘录 重点 进 : 


进行 讲解 才 


commander、domain 和 async 等 组 件 或 模块 的 了 解 ， 建 议 参阅 文中 提 到 的 相关 章节 或 查看 官方 文档 。 


第 11 章 一 个 精巧 的 P2P 网 络 实现 


区 块 链 产品 都 是 去 中 心 化 的 应 用 ， 去 中 心 化 的 基础 就 是 P2P 网 络 ， 因 此 P2P 网 络 的 人 有 


不 开源 的 所 谓 私 链 (私有 区 块 链 ) ， 有 人 认为 P2P 网 络 不 是 必需 的 ， 对 了 


于 这 一 点 笔者 不 敢 苟同 。 


P2P 网 络 并 不 是 什么 新 技术 。 但 是 ,使 


Node.js 开 发 的 P2P 网 络 ， 确 实 值得 学 习 和 借鉴 。 本 章 


需要 花费 大 量 篇 幅 。 如 果 你 觉得 


对 本 章 的 理解 并 不 轻松 ， 甚 至 还 有 些 


和 地 位 不 言 而 喻 ， 无 可 替代 。 因 此 ， 笔 者 的 观点 是 ， 没 有 P2P 网 络 的 产品 ， 不 能 称 为 


就 来 学 习 亿 书 的 P2P 网 络 是 如 何 实现 的 。 


字 逐 句 地 去 读 ， 那 样 不 仅 效率 低 ， 效 果 也 差 。 


困难 ， 那 么 可 能 是 因为 你 缺少 对 


区 块 链 产品 。 当 然 ， 对 于 一 个 


11.1 源码 、 类 图 与 流程 图 


1 源码 


本 章 所 涉及 的 主要 源码 地 址 具体 如 下 。 


peerjs: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/modules/peer.js 


transport.js: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/modules/transport.js 


router.js: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/helpers/router.js 


Peer 类 图 及 其 关联 关系 如 图 11-1 所 示 。 


3. 流 程 | 


区 


Peer 类 主要 函数 的 调用 流程 图 如 图 11-2 所 示 。 


触发 事件 
自己 实现 的 事件 处 理 方法 ， 简 单 实用 


library.bus.message('bind') 


11.2 解读 


对 于 基于 HTTP 的 Web 应 用 ， 抓 住 路 由 的 定义 、 设 计 与 实现 ， 是 快速 弄 清 业 务 逻 辑 的 简 和 


© onBind(scope): voi 
@ onBlockchainReady(scope) 
© onPeerReady(): void 


《Nodejs 开 发 加 密 货币 》 第 八 简 分 析 用 图 


一 个 简单 的 辅助 类 站 


。 其 他 实例 通过 请 求 map() 方法 映射 路 由 


router.map(shared, 1) 


ODO modules: array 
D library array 
D private : hash 


@ attachApi0: void 


@ updatePeerList(cb): void 
@ Count(cb): void 

@ banManager(cb): void 
m getByFilter(cbj void 


@ list(options, cb): rows 


©® state(pip, port, state, timeoutSeconds, cb): rows 
© remove(pip, port, cbj: void 

© addDapp(config, cb): void 

© update(peer, cb): void 

© sandboxApi(call args, cb): void 


m getPeers(req, cb): void 
m getPeer(req, cbj: void 
目 version(req, cbj void 


copyright (c) imfly 2016.03.01 http://book.btcnodejs.com 


图 11-1 Peer 类 图 及 其 关联 关系 


设计 上 相互 独立 ， 互 不 冲突 ， 逻 辑 清晰 ， 这 为 我 们 的 学 习 和 分 析 提 供 了 很 大 的 便利 。 


11.2.1 ”路 由 扩展 


任何 应 用 只 要 提供 Web 访 问 能 力 或 第 三 方 访问 的 APl， 都 需要 提供 从 地 址 到 逻辑 的 请 求 分 发 功能 ， 这 就 是 路 由 。 亿 书 是 基于 


此 其 路 由 设计 简单 而 灵活 。 


FHTTP 协 议 的 Express 应 


方法。 目前 分 析 的 是 modules 文 件 夹 下 的 各 个 模块 文件 ， 这 些 模 块 基本 上 都 是 独立 的 Express 微 应 用 ， 在 开发 和 


，Express 底 层 是 基于 Node.js 的 connect 模 块 ， 因 


读 节 点 流程 写 节点 流程 
pn 


private.getByFilter() 


modules.transport.getFromRandomPeer() 
peer.onBlockchainReady() async.retry(20,,,) 


peer in sqlite ? 


久 一 AR 


no 


peer? 


(ee) Gr) 9 


private.count() transport.getFromPeer() 


count>0 


Wwarn('Peers list is empty') try get 'http://peer.ip:peer.port + Url 
private.updatePeerList() 《> 


Er 人 


no 


yes 
2 peupaed 2 


对 不 合法 的 IP 节 点 ，Peer 类 中 的 state 方 法 更 改 
Peer 类 中 remove 方 法 调用 | 其 状态 为 0， 并 禁止 10 分 钟 。 其 banManager 方 法 ， 
会 定期 循环 将 其 状态 为 从 0 更 改 为 1。 


ss 


循环 执行 


copyright (¢) imfly 2016.03.01 http://book.btcnodejs.com 


图 11-2 ”Peer 类 主要 函数 的 调用 流程 图 


第 二 部 分 就 已 经 提 到 过 对 路 由 的 分 拆 调用 ， 下 面 是 对 其 的 简单 实现 。 先 来 看 helperrouterjs 文 件 : 


XW 
Var Router = function () { 
Var router = require('express') .Router (); 


router.use (function (req, res, next) { 
res.header ("Access-Control-Allow-Origin", "™*"); 


res.header ("Access-Control-Allow-Headers", "Origin, X-Requested-With, Content-Type, Accept"); 
next (); 


1)s 
router.map = map; 


return router; 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


这 段 代码 定义 了 一 个 Express 路 由 器 Router， 并 扩展 了 如 下 两 个 功能 。 


“ 允许 任何 客户 端 调用 。 其 实 就 是 设置 了 跨 域 请 求 ， 选 项 Access-Conttol-Allow-Ortigin 被 设置 为 *， 自 然 ， 任 何 IP 和 端口 的 节点 都 可 以 访问 和 被 访问 。 


“ 添加 了 地 址 映射 方法 。 该 方法 的 主要 内 容 如 下 : 


// 3 行 


function map(root, config) 


var router = this; 


i 


Object .keys (config) .forEach (function (Params) { 
Var route = params.split (""); 


if (route.length != 2 || ["post", "get", "put"] .indexOf (route[0]) = -1) { 
throw Error ("wrong map config"); 


} 


router[route[0]] (route[1], function (req, res, next) { 
] 


root [config[params] 


if (err) 


({"body": route[0] == "get" ? req.query : req.body}, function (err, response) { 


res.json({"success": false, "error": err}); 


} else { 


return res.json(extend({}, {"success": true}, response)); 


该 方法 接受 如 下 两 个 对 象 作为 参数 。 


“ toot: 定义 了 所 要 开放 API 的 逻辑 函数 。 


“config: 定义 了 路 由 与 foot 所 定义 的 函数 之 间 的 对 应 关系 。 


其 运行 的 结果 相当 于 : 


router.get ('/peers', function(req, res, next){ 


DD 


root .getPeers (http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/...); 


这 里 有 一 个 关键 的 小 技巧 ， 在 JavaScript 代 码 中 ， 对 象 也 是 散 列 值 ，root.getPeers () 与 root[getPeers] 是 一 致 的 。 不 过 后 者 可 以 用 字符 串 变量 来 代替 ， 


此 更 加 灵活 ， 这 就 有 点 像 Ruby 里 的 元 编程 ， 


这 是 脚本 语言 的 优势 (简单 的 字符 串 拼接 处 理 ) 。 


在 这 里 我 们 来 扩展 一 下 ， 在 类 似 Sails 的 框架 (基于 Express) 里 ， 其 实 很 多 都 是 可 以 使 用 类 似 configjson 的 文件 直接 配置 的 ， 包 括 路 由 。 参 考 这 个 函数 ， 就 很 容易 理解 和 实现 。 


11.2.2 ”节点 路 由 


很 轻松 就 能 在 文件 peerjs 里 找到 上 述 map 方 法 的 使 用 代码 : 


J 


Router = require('http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/../helpers/router.js') 


A/ 25 


privated.attachApi = function () { 
Var router = new Router (); 


router.use (function (req, res, next) { 
if (modules) return next(); 


jys 


// 34 行 
router.map (shared, { 


"get /": "getPeers", 


res.status (500) .send({success: false, error: "Blockchain is loading"}); 


"get /version": "version", 
"get /get": "getPeer" 


js 


router.use (function (req, res) { 


D); 
// 44 行 


res.status (500) .send ({success: false, error: "API endpoint not found"}); 


library.network.app.use('/api/peers', router); 
library.network.app.use (function (err, req, res, next) { 
if (lerr) return next(); 
library.logger.error (req.url, err.toString()); 


1D); 


res.status (500) .send({success: false, error: err.toString()}); 


查看 上 面 代码 的 34 行 处 ， 很 直观 就 可 以 想象 到 ， 会 有 类 似 /version 的 路 由 出 现 ，44 行 处 是 Express 应 用 的 调 


个 公共 API 的 地 址 : 


逻辑 ， 这 里 是 将 定义 好 的 路 由 放 在 /apipeers 前 缀 之 下 ， 可 以 确信 peerjs 文 件 提供 了 下 


回 
Wu 


http:// ip:port/api/peers/ 


http:// ip:port/api/peers/version 
http:// ip:port/api/peers/get 


当然 ， 是 不 是 可 以 直接 这 么 调 
限定 条 件 吧 。 下 面 来 看 源码 : 


， 还 要 看 具体 对 应 的 函数 是 否 还 有 其 他 的 参数 要 求 ， 比 如 : /apipeers/get 按 照 Restful API 的 设计 原则 可 以 理解 为 是 获得 某 个 具体 节点 的 信息 ， 那 么 总 该 给 个 id 之 类 的 


// 455 行 


library.scheme.validate (query, { 


type: "object", 
properties: { 
Tp Btrs 4 


type: "string", 


minLength: 1 


type: "integer", 


minimum: 0, 


maximum: 65535 


} 
kx 


required: ['ip str', 


}, function (err) { 


'port'] 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
// 480 行 
Privated.getByFilter ({ 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
]); 


这 里 ， 在 具体 的 运行 过 程 中 ，library 就 是 app.js 里 传 过 来 的 scope， 该 参数 包含 的 scheme 代 表 了 一 个 z_schema 实 例 。 


z_schema 是 一 个 第 三 方 组 件 ， 具 体 请 看 11.4 节 中 给 出 的 链接 。 该 组 件 提供 了 JSON 数 据 格 式 的 验证 功能 。 上 述 代码 的 意思 是 对 请 求 参数 query 进 行 验证 ， 验 证 的 规则 是 : object 类 型 ， 属 性 ip_str 要 求 长 
度 不 小 于 1 的 字符 串 ， 属 性 port 要 求 0 ~ 65535 之 间 的 整数 ， 并 且 都 不 能 为 空 (必须 不 为 空 ) 。 


这 就 说 明 ， 应 该 像 这 样 进行 请 求 : http://ip:port/api/peers/get?ip_str=0.0.0.0&port=1234， 不 然 会 返回 错误 信息 。 再 回 过 头 来 看 看 getPeers 方 法 的 实现 ， 其 中 没有 required 字 段 ， 因 此 可 以 直接 访 
间 http://ip:port/api/peers/。 


查看 480 行 处 的 代码 ， 上 面 的 地 址 都 会 调用 privated.getByFilter () ， 并 由 它 从 SQLite 数 据 库 里 查询 数据 表 peers。 这 里 涉及 的 dblite 第 三 方 组 件 (请 看 11.4 节 中 给 出 的 链接 ) ， 对 请 求 操作 SQLite 数 据 
库 进 行 了 简单 的 封装 。 


11.2.3 ”节点 保存 


大 多 数 应 用 的 读数 据 操作 都 相对 简单 ， 难 点 在 于 写 数据 。 上 面 的 代码 都 是 get 请 求 ， 用 于 查询 节点 及 其 信息 。 接 下 来 自然 会 问 ， 查 询 的 信息 是 从 哪里 来 的 ? 初始 的 节点 在 哪里 ? 节点 变更 了 应 该 怎么 办 ? 


1. 初 始 化 节点 


从 现实 的 角度 来 考虑 ， 在 一 个 P2P 网 络 中， 一 个 孤立 的 节点 ， 在 没有 其 他 任何 节点 信息 的 情况 下 ， 仪 仪 靠 网 络 扫描 去 寻找 其 他 的 节点 ， 将 是 一 件 很 难 完成 的 事情 ， 更 别提 高 效 性 和 安全 性 了 。 


因此 ， 在 软件 运行 之 前 ， 初 始 化 一 些 节点 以 供 联网 使 用 ， 是 最 简单 、 最 直接 的 解决 方案 了 。 这 一 点 在 配置 文件 configjson 里 也 有 直接 的 体现 : 


// config.json 15 行 


We Fla 
"plackList”s [js 
"options": { 
"timeout": 4000 
; } 

7 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
1ist 的 数据 格式 为 : 和 
上 

{ 
ip: 0.0.0.0; 
port: 7000 


’ 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


当然 ， 也 可 以 在 启动 的 时 候 通 过 参数 “--peers 1.2.3.4: 70001，2.1.2.3: 7002” 提 供 初始 节点 列表 (具体 代码 请 参见 appjs 源 码 的 第 47 行 )。 


2. 写 入 节点 


写 入 节点 ， 就 是 对 节点 信息 进行 持久 化 ， 或 者 保存 到 数据 库 ， 或 者 保存 到 某 个 文件 中 。 这 里 是 将 节点 保存 到 SQLite3 数 据 库 里 的 peers 表 中 ， 代 码 如 下 : 


// peer.js 347 行 
Peer .prototype.onBlockchainReady = function () { 
async.eachSeries (library.config.peers.list, function (peer, cb) { 
library.dbLite.query ("INSERT OR IGNORE INTO peers (ip, port, state, sharePort) VALUES ($ip, $port, $state, $sharePort)", { 
ip: ip.toLong (peer.ip), 
port: peer.port, 
state: 2，// 初始 状态 为 2， 都 是 健康 的 节点 
sharePort: Number (true) 
}, cb); 
}, function (err) { 
if (err) { 
library.logger.error ('onBlockchainReady', err); 


} 


privated.count (function (err, count) { 
if (count) { 
Privated.updatePeerList (function (err) { 
err && library.logger.error('updatePeerList', err); 
// 364 行 
library.bus.message ('PeerReady' ) ; 


library.logger.info('Peers ready, stored ' + count); 
} else { 
library.logger.warn('Peers list is empty'); 


这 段 代码 的 意思 是 ， 当 区 块 链 加 载 完毕 的 时 候 (触发 事件 ) ， 依 次 将 配置 的 节点 写 入 数据 库 ， 如 果 数 据 库 已 经 存在 相同 的 记录 就 忽略 该 节点 ， 然 后 更 新 节点 列表 。 如 果 执 行 成 功 ， 就 会 调 
library.bus.message ('peerReady') (364 行 ) ， 进 而 触发 peerReady 事 件 。 该 事件 的 功能 就 是 更 新 节点 。 


这 里 对 数据 库 SQLite 进 行 了 插入 操作 ， 插 入 语句 是 library.dbLite.query ("INSERT OR IGNORE INTO peers， 有 意思 的 是 ，IGNORE 操 作 字 符 串 ， 是 SQLite3 所 支持 的 ( 见 11.4 节 ) ， 当 数据 库存 在 相 
同 的 记录 时 ， 该 记录 将 会 被 忽略 ， 然 后 继续 往 下 执行 。 


3. 更 新 节点 


事件 onPeerReady 函 数 的 具体 代码 如 下 : 


// peer.js 374 行 
Peer .prototype.onPeerReady = function () { 
setImmediate (function nextUpdatePeerList() { 
privated.updatePeerList (function (err) { 
err && library.logger.error('updatePeerList timer', err); 
setTimeout (nextUpdatePeerList, 60 * 1000); 
}) 
]); 


setImmediate (function nextBanManager() { 
privated.banManager (function (err) { 
err && library.logger.error('banManager timer', err); 
setTimeout (nextBanManager, 65 * 1000) 


该 代码 中 有 两 个 setlImmediate 函 数 的 调 上 


(1) 第 一 个 循环 调 


下 面 来 看 看 第 一 个 循环 调 


的 函数 updatePeerList， 代 码 如 下 : 


: 一 个 是 循环 更 新 节点 列表 ， 另 一 个 是 循环 更 新 节点 状态 。 


privated.updatePeerList = function (cb) { 
/7 -53 行 
modules.transport .getFromRandomPeer ({ 
pi biet', 
method: "GET' 
}, function (err, data) { 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


library.scheme.validate (data.body, { 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


// 124 行 
self.update (peer, cb); 
}); 
}, ch); 


查看 53 行 处 的 代码 可 以 知道 ， 程 序 通 过 transport 模 块 的 .getFromRandomPeer 方 法 ， 随 机 地 获取 节点 并 验证 节点 信息 ， 然 后 对 其 进行 删除 和 更 新 处 理 。 如 此 一 来 ， 各 种 调 


也 会 更 加 直观 。.getFromRandomPeer 的 代码 具体 如 下 : 


关系 就 更 加 清晰 了 ， 看 流 


// transport.js 474 行 


Transport .prototype.getFromRandomPeer = function (config, options, cb) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


// 481 行 
async.retry(20, function (cb) { 
modules.peer.list (config, function (err, peers) { 
if (!err && peers.length) { 
var Peer = peers[0]; 


// 485 行 

self.getFromPeer (peer, options, cb); 
} else { 

return cblerr || "No peers in db"); 


} 
D); 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


}; 


代码 很 简单 ， 的 是 要 理解 async.retry 的 有 


法 (参见 第 21 章 ) 。 该 方法 就 是 


getFromPeer 函 数 。 该 函数 是 检验 处 理 现存 节点 的 核心 函数 ， 其 代码 


重复 调 有 


体 如 下 : 


第 一 个 task 函 数 20 次 ， 若 正确 返 


回 


结果 则 传 给 


回 


调 函 数 。 在 这 里 ， 只 要 查 到 一 个 节点 ， 就 会 传 给 485 行 处 的 


// transport.js 500 行 
Transport .prototype.getFromPeer 


function (peer, options, cb) { 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


var req={ 
// 519 行 : 获得 节点 地 址 


有 


'http:// ' + 让 .fromLong (Peer.ip) + ':' + peer.port + url， 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


}; 
// 532 行 : 使 用 'request' 组 件 发 送 请求 


return request (req, function (err, response, body) { 
if (err || response.statusCode != 200) { 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


if (peer) { 
if (err && 
err.code == "ECONNREFUSED")) { 


// 542 行 ， 对 于 无 法 请 求 的 ， 自 然 要 删除 


(err.code == "ETIMEDOUT" || err.code == "ESOCKETTIMEDOUT" || 


modules .peer .remove (peer.ip, peer.port, function (err) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


D); 
} else { 
if (!options.not ban) { 


// 549 行 :对 于 状态 码 不 是 200 的 ， 比 如 304 等 禁止 状态 ， 就 要 更 改 其 状态 
modules .peer. state (peer.ip, peer.port, 0, 600, function (err) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


D); 
} 
cb && cblerr || 


return; 


} 


('request status code' + response.statusCode)); 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


if (Port > 0 && 
// 595 行 : 一 切 问 题 都 不 存在 
modules.peer.update ({ 
ip: peer.ip, 
port: port, 
state: 2，// 598 行 : 看 来 健康 的 节点 状态 为 2 


port <= 65535 && response.headers['version'] 


library.config.version) { 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


这 旦 


的 是 532 行 处 的 代码 ， 关 于 request 第 三 方 组 件 的 使 用 ， 


测试 。 


(2) 第 二 个 循环 调 


第 二 个 循环 调 


的 函数 很 简 


， 就 是 循环 更 改 state 和 clock 字 段 ， 


请 查看 11.4 节 中 给 出 的 链接 。 官 方 称 request 为 简 和 


要 是 将 禁止 的 状态 state=0， 修 改 为 1， 代 和 码 


体 如 下 : 


有 的 HTTP 客 户 端 ， 功 能 足够 强大 ， 可 以 模拟 浏览 器 访问 信息 ， 经 常 被 


来 进行 模拟 


// 142 行 
privated.banManager 


function (cb) { 


library.dbLite.query ("UPDATE Peers SET state = 1, clock = null where (state 


0 and clock - $now < 0)", 
} 


{now: Date.now()}, cb):; 


回 


综 上 所 述 ， 整 个 P2P 网 络 的 读 写 和 更 新 都 已 经 很 清楚 了 ， 这 时 再 | 


过 头 来 看 上 


网 


的 流程 就 更 加 明朗 了 。 


图 和 类 


11.3 总结 


本 章 重 点 解析 了 peerjs 文 件 ， 学 习 了 一 个 使 用 Nodejs 开 发 的 P2P 网 络 架构 ， 其 特点 具体 如 下 。 


“ 产品 提供 了 初始 节点 列表 ， 以 保障 初始 化 节点 快速 完成 ， 而 不 至 于 成 为 孤立 节点 。 


: 节点 具备 跨 域 访问 的 能 力 ， 任 何 节 点 之 间 都 可 以 自由 访问 。 


:节点 具备 自我 更 新 的 能 力 ， 定 期 查询 和 更 新 死 掉 的 节点 ， 以 保障 网 络 始终 畅通 。 


节点 一 旦 达到 一 定 的 数量 ， 就 会 形成 一 个 互 连 互通 的 “不 死 ” 网 络 。 搭 建 在 这 种 网 络 上 的 服务 会 充满 怎样 的 诱惑 ? 


多 的 遐想 空间 。 


本 章 所 分 析 的 代码 涉及 了 dblite、request、z_schema 等 第 三 方 组 件 ， 以 及 亿 书 自行 实现 的 事件 处 理 方法 library.bus (代码 在 appjjs 文 件 中 ) ， 这 些 都 很 简 征 


自行 查阅 。 


11.4 参考 


z_schema 组 件 : https://github.com/Ebookcoin/z_schema 


dblite 组 件 : https://github.com/Ebookcoin/dblite 


request 组 件 : http://github.com/request/request 


SQL As Understood By SQLite: https://www.sqlite.org/lang_conflict.html 


第 12 章 ”加 密 和 验证 


区 块 链 为 什么 会 被 认为 是 下 一 代 互 联网 ? 这 加 起 来 不 足 干 行 的 代码 ， 可 以 给 我 们 足够 


， 后 续 将 不 再 分 享 或 赣 述 ， 读 者 若 有 需要 请 


密码 学 技术 在 区 块 链 开发 中 的 作用 不 言 而 喻 ， 但 该 技术 本 身 并 不 是 什么 新 鲜 事 ， 如 果 没 有 前 面 的 P2P 网 络 和 后 面 将 要 介绍 的 区 块 链 ， 那 么 单独 的 密码 学 技术 显然 就 没有 那么 神奇 ， 区 块 链 也 不 会 成 为 无 


须 验证 、 高 度 可 信 的 强大 网 络 的 底层 技术 。 


如 今 一 提 到 密码 学 技术 ， 业 界 的 通则 是 使 用 现成 的 组 件 ， 严 格 按照 文档 去 做 ， 不 要 自作 聪明 ， 这 也 是 使 用 密码 学 技术 最 安全 的 方式 。 本 章 将 介绍 亿 书 是 如 何 使 用 密码 学 技术 的 。 


12.1 源码 、 类 图 与 流程 图 


1. 源 码 


亿 书 没有 提供 相关 的 扩展 ， 全 部 使 用 Nodejs 自 己 的 crypto 模 块 进行 加 密 ， 使 用 Ed25519 组 件 进行 签名 认证 。 本 章 所 涉及 的 


源码 地 址 具 


体 如 下 。 


accounts.js: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/modules/accounts.js 


account.js: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/logic/account.js 


Crypto 模 块 的 使 


网 


3. 流 程 


[ 


和 关联 情况 如 图 12-1 所 示 。 


modules/accounts.js 中 生成 Hash 地 址 的 流程 图 如 图 12-2 所 示 。 


Be CE 
上 


<4> modules/delegates.js 和 <3> modules/contacts.js [<2> modules/dapps.js / <1> modules/accounts.js <a> logic/block.js 


国 wunisgnature <5> modulssfmtHtisignaiDres-js Op cogtettrarisaction.]s 
一 一 一 
i 


一 
一 
Ca 


a 和 <6> modules/signatures.js \<7> modules/transactions.js <8> modules/transport.js 


这 是 Nodejs 模 块 ， 自 己 定义 Transport 


copyright (¢) imfly 2016.03.09 http://bitcoin-on-nodejs.ebookchain.org 


图 12-1 Crypto 模 块 的 使 用 和 关联 情况 


接口 方法 开始 


post /apl/accounts/generatePublicKey 
shared,.generatePublickey() 


private.openAccount(secret, cb) 
hash = crypto.createHash('sha256').update(secret, 'utf8'),.digest(); 
ed.MakeKeypair(hash), 


setAccountAndGet(data, cb); 


self.generateAddressByPublicKey(data.publicKey) 


copyright (c¢) imfly 2016.03.10 http://bitcoin-on-nodejs.ebookchain.org 


图 12-2 modules/accounts.js 中 生成 散 列 地 址 的 流程 图 


12.2 概念 


本 节 仅 对 所 涉及 的 最 少 概念 做 一 个 简单 介绍 。 


12.2.1 ” 私 钥 和 公 钥 


加 密 技术 所 涉及 的 概念 大 多 星 汲 难 懂 ， 先 讲 一 个 小 故事 以 帮助 理解 。 一 男生 想 追 一 女生 ， 但 是 “有 了 贼 心 没 贼 胆 ”， 一 直 不 敢当 面 说 “| love you”， 于 是 他 想 了 一 招 ， 顺 手写 下 “J mpwf zpv” 交 给 了 
另 一 位 女生 ， 让 她 帮忙 传 信 。 然 后 ， 等 他 心仪 的 女生 感到 好 奇 打 来 电话 询问 时 ， 他 就 告诉 她 依次 向 前 顺延 1 个 字母 ， 组 合 起 来 就 是 他 想 说 的 话 。 


暂且 不 论 追 女 朋友 的 这 个 招数 能 否 成 功 ， 先 看 其 中 的 概念 : 这 里 的 “| love you” 就 是 明文 ， “J mpwf zpv” 就 是 密 文 ， 向 后 顺延 1 个 字母 是 加 密 过 程 ， 向 前 顺延 是 解密 过 程 ， 而 这 个 规则 就 是 算法 。 这 
种 简单 的 加 解密 过 程 ， 称 为 “对 称 加密 ”。 其 缺点 很 显然 ， 必 须 得 打 电 话 告诉 女 朋友 怎么 解密 ， 但 难免 隔 墙 有 耳 ， 安 全 性 堪忧 。 


当然 ， 更 安全 的 方式 是 不 用 打 电 话 也 能 处 理 。 这 里 就 要 涉及 私 钥 和 公 角 的 概念 ， 它 们 都 是 长 长 的 字符 串 值 ， 私 钥 好 比 银行 卡 的 密码 ， 公 钥 好 比 银 行 卡 的 账户 ， 账 户 谁 都 可 以 知道 ， 但 只 有 掌握 私 钥 密 码 
的 人 才能 操作 。 不 过 ， 私 钥 和 公 钥 更 为 贴心 与 先进 ， 用 私 钥 签名 的 信息 ， 公 钥 可 以 验证 确认 ， 反 之 ， 用 公 钥 签名 的 信息 ， 私 钥 也 可 以 验证 确认 。 这 就 为 网 络 传输 提供 了 便利 。 这 种 使 用 公 钥 和 私 钥 的 密码 学 
方法 又 称 为 “ 非 对 称 加 密 ”。 


12.2.2 ”加 密 货币 地 址 


以 加 密 货 币 的 鼻祖 一 一 比特 币 为 例 ， 一 个 比特 币 地址 就 是 一 个 公 铜 ， 在 交易 中 ， 比 特 币 地 址 通常 以 收 款 人 的 形式 出 现 。 如 果 把 比特 币 交易 比喻 为 一 张 支票 ， 那 么 比特 币 地址 就 是 收 款 人 ， 也 就 是 在 支票 
的 收 款 人 一 栏 中 要 填写 的 内 容 。 


而 私 钥 只 是 一 个 随机 选 出 来 的 字符 串 而 已 ， 在 比特 币 交易 中 ， 私 钥 用 于 生成 支付 比特 币 所 必需 的 签名 以 证 明 资 金 的 所 有 权 ， 即 地 址 中 的 所 有 资金 的 控制 取决 于 相应 私 钥 的 所 有 权 和 控制 权 。 


私 钥 必 须 始终 保持 机 密 ， 因 为 一 旦 被 泄露 给 第 三 方 ， 就 相当 于 该 私 钥 保 护 之 下 的 比特 币 也 拱手 相让 给 了 他 人 了 。 私 钥 还 必须 进行 备份 ， 以 防 意外 丢失 ， 因 为 私 钥 一 旦 丢失 将 会 难以 复原 ， 其 所 保护 的 比特 
币 也 将 永远 无 法 找 回 。 


亿 书 也 是 如 此 ， 只 不 过 更 加 直接 地 将 生成 的 公 钥 地 址 作为 用 户 的 !ID， 用 作 网 络 中 的 身份 证 明 ， 更 加 强调 用 户 应 该 仔细 保存 最 初 设 定 的 长 长 的 密码 串 ， 以 代替 单纯 的 私 钥 保存 ， 因 而 也 更 加 灵活 。 


12.2.3 ”加 密 过 程 


Nodejs 的 crypto 模 块 ， 提 供 了 一 种 封装 安全 凭证 的 方式 ， 用 于 HTTPS 网 络 或 HTTP 连 接 ， 也 对 OpenSSL 的 Hash、HMAC、 加 密 、 解 密 、 签 名 和 验证 方法 进行 了 封装 。 


在 币 圈 里 ， 谈 到 加 密 技术 时 ， 经 常会 听 到 Hash 算 法 。 很 多 程序 员 时 常会 将 其 与 数组 (array) 和 散 列 (hash) 等 数据 格式 相 混 淆 ， 误 以 为 Hash 算 法 所 获得 的 结果 都 像 JSON 格 式 的 键 值 对 一 样 。 其 实 ， 
这 是 文化 上 的 差异 ，Hash 的 中 文 翻译 是 : “名 词 ， 混 杂 ， 拼 凑 ; 动词 ， 搞 糟 ， 把 .…. 弄 乱 的 意思 ”。 所 以 ， 所 谓 的 Hash 算 法 ， 直 译 为 混杂 算法 或 弄 乱 算 法 ， 可 能 让 人 感觉 更 好 理解 些 。 


亿 书 使 用 的 是 sha256 Hash 算 法 ( 除 此 之 外 ， 还 有 MD5、sha1、sha512 等 ) ， 该 算法 是 经 过 很 多 人 验证 的 有 效 安全 的 算法 之 一 (相关 实践 参见 12.3 节 ) 。 下 面 就 来 通过 crypto 模 块 ， 简 单 加 密生 成 一 
个 散 列 值 : 


Var hash = crypto.createHash('sha256') .update (data) .digest () 


将 这 个 语句 拆 开 来 看 ， 就 是 crypto.createHash ('sha256') 先 用 sha256 算 法 创建 一 个 Hash 实 例 ; 接着 使 用 .update (data) 接收 明文 data 数 据 ， 最 后 调用 .digest () 方法 获得 加 密 字符 串 ， 即 密 文 。 


然后 ， 使 用 Ed25519 组 件 ， 直 接 简单 地 生成 对 应 的 密 铀 对， 代码 如 下 : 


Var keypair = ed.MakeKeypair (hash); 


12.2.4 ”验证 过 程 


了 Ed25519 第 三 方 组 件 ， 该 组 件 封装 了 数字 签名 算法 ， 签 名 过 程 不 依赖 随机 数 


加 密 技术 的 作用 重 在 传输 和 验证 ， 所 以 加 密 货 币 并 不 需要 研究 如 何 解密 原文 ， 而 是 如 何 进行 安全 、 快 捷 的 验证 。 亿 书 使 


生成 器 ， 因 此 不 存在 时 间 通 道 攻击 的 问题 ， 签 名 和 公 钥 都 很 小 。 签 名 和 验证 的 性 能 很 高 ， 一 个 4 核 2.4GHz 的 Westmere CPU， 每 秒 可 以 验证 71000 个 签名 ， 安 全 性 极 高 ， 等 价 于 RSA 约 3000bit， 验 证 代码 只 


有 一 行 : 


Var res = edq.Verify (hash，signatureBuffer || ' ', publicKeyBuffer || ' '); 


12.3 ”实践 


在 亿 书 世界 里 ， 亿 书 将 用 户 设 定 的 密码 生成 私 钥 和 公 钥 ， 再 将 公 钥 经 过 十 六 进 制 字符 串 转换 产生 账号 ID (类 似 于 比特 币 地 
度 通常 是 160 比 特 (20 字 节 ) ， 再 加 上 末尾 的 L 后 级 ， 总 长 度 为 21 字 节 。 


址 ) 。 付 款 的 时 候 ， 只 要 输入 这 个 账号 ID (或 用 户 别名 ) 就 可 以 了 。 该 ID 的 长 


病 


因此 ， 在 使 用 的 过 程 中 会 发 现 ， 软 件 ( 比 如 钱包 程序 ) 仅仅 要 求 输入 密码 (通常 很 长 ) ， 而 不 像 传统 的 网 站 ， 还 需要 输入 


亿 书 要 求 用 户 保存 好 最 初 设 定 的 、 长 长 的 明文 密码 串 ， 它 是 找 回 账号 (保存 着 用 户 的 加 密 货币 财富 ) 的 真正 钥匙 。 这 比 直接 保管 私 钥 方便 得 多 ， 当 然 ， 这 种 方式 也 会 存在 风险 ， 特 别 是 对 于 那些 喜欢 


短 密码 的 人 来 说 。 为 此 ， 亿 书 提供 了 二 次 签名 (类 似 于 支付 密码 ) 、 多 重 签名 等 措施 来 弥补 这 些 问题 。 


下 面 仅 研 究 一 下 用 户 ID 的 生成 以 体验 上 述 的 过 程 ， 代 码 如 下 : 


户 名 之 类 的 信息 。 这 通常 就 是 加 密 货币 的 好 处 ， 既 保证 了 安全 ， 也 实现 了 


// modules/accounts.js 628 行 

shared.generatePublickey = function (req, cb) { 
Var body = req.body; 
library.scheme.validate (body, { 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


required: ["secret"] 
Fz function (err) 1 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


// 644 行 
privated.openAccount (body.secret, function (err, account) { 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


cblerr, { 
publicKey: publicKkey 


// 447 行 

privated.openAccount = function (secret, cb) { 
Var hash = crypto.createHash('sha256') .update (secret, 'utf8').digest(); 
Var keypair = ed.MakeKeypair (hash); 


self.setAccountAndGet ({publicKey: keypair.publicKey.toSstring('hex')}, cb); 
js 
// 482 行 
Accounts .prototype.setAccountAndGet = function (data, cb) { 

var address = data.address || null; 

if (address === null) { 

if (data.publicKey) { 
// 486 行 


address = self.generateAddressByPublicKey (data.publicKey); 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EB) 


Ll 


PS/Text/... 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


// 494 行 
library.logic.account.set (address, data, function (err) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS 
和 
}s 


// modules/accounts 455 行 
Accounts .prototype.generateAddressByPublicKey = function (publicKey) { 
Var publicKeyHash = crypto.createHash('sha256') .update (publicKey, 'hex') .digest (); 
var temp = new Buffer (8):; 
for (var i = 0; i < 8; i++) { 
temp[i] = PublicKeyHash[7 - i]; 
} 
Var address = bignum.fromBuffer (temp) .toString() + 'L'; 
if (laddress) { 
throw Error ("wrong publicKey " + publicKey): 


return address; 


/Text/... 


generateAddressByPublicKey。455 行 处 的 代码 再 次 对 公 钥 进 行 加 密 ， 然 后 做 十 六 进 制 处 理 ， 以 得 到 所 要 的 加 密 货币 地 址 。 


上 面 628 行 处 的 代码 是 产生 公 钥 的 方法 ， 通 常 需要 用 户 提 供 一 个 密码 (secret) 。447 行 处 的 代码 对 用 户 密码 进行 加 密 处 理 ， 然 后 直接 生成 了 密 钥 对 ， 接 着 再 继续 处 理 公 钥 。486 行 处 的 代码 调用 了 方法 


上 述 过 程 中 ， 对 于 私 钥 没 有 任何 处 理 ， 直 接 无 视 了 。 这 是 因为 ， 这 里 使 用 的 方法 是 ed25519， 基 于 某 个 明文 密码 的 处 理 结果 不 是 随机 的 ， 用 户 只 要 保护 好 自己 的 明文 密码 字符 串 ， 就 可 以 再 次 生成 对 应 


的 私 钥 和 公 钥 。 
12.4 ”总结 


密码 学 技术 的 专业 性 很 强 ， 需 要 花费 大 量 的 时 间 和 精力 深入 研究 。 笔 者 在 前 人 研究 成 果 的 基础 上 进行 了 汇总 和 再 加 工 ， 绘 制 了 三 张 脑 图 ， 详 情 参见 第 24 章 。 本 章 权 当 入 门 知识 讲解 ， 并 没有 对 交易 、 


块 链 和 委托 人 等 的 加 密 验 证 处 理 过 程 进 行 分 析 ， 加 密 解 密 过 程 都 比较 类 似 ， 后 续 章 节 会 对 此 做 进一步 说 明 。 


内 


12.5 参考 


Ed25519 官 方 网 站 : http://ed25519.cr.yp.to/ 


第 13 章 ”地址 


第 12 章 专门 研究 了 加 密 和 验证 的 技术 ， 了 解 了 亿 书 对 于 密码 学 技术 的 简单 使 用 情况 。 我 们 常 说 ， 区 块 链 处 处 都 要 用 到 加 密 解 密 技术 ， 这 绝对 不 是 一 句 空话 ， 本 章 就 从 最 基础 的 加 密 货币 地 址 开始 ,来 学 
习 和 体会 这 句 话 的 意义 。 


13.1 源码 、 类 图 与 流程 图 


1. 源 码 


本 章 所 涉及 的 主要 源码 地 址 具体 如 下 。 


account.js: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/logic/account.js 
accounts.js: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/modules/accounts.js 


contacts.js: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/modules/contacts.js 


地 址 主要 通过 modules/accounts.js 模 块 进行 处 理 ， 其 类 图 及 关联 关系 如 图 13-1 所 示 。 


<<require>> \<<require>> F<require>> <<require>> /<<require>> 


OD, modules: 0 
D library: 0 


private methods 
国 attachApi: 0 
国 OpenAccount : (secret, cb) 


© generateAddressByPublicKey: (publicKey) 
© getAccount: (filter fields, cb) 

© getAccounts: (filter, fields, cb) 

© SetAccountAndGet (data, cb) 

© mergeAccountAndGet: (data, cb) 

© sandboxApi: (call, args, cb) 


@ onBind: (scope) 

shared methods 一 
© open: (req, cb) 
© getBalance: (req, cb) 
© getPublickey: (req, cb) 
© generatePublickey: (req, cb) 
© getDelegates: (req, cb) 
© getDelegatesFee: (req, cb) 
© addDelegates: (req, cb) 
© getUsernameFee: (req, cb) 
© addUsername: (req, cb) 
© getAccount: (req, cb) 
© getUsername: (req, cb) 


口 genesisblock: scope.genesisblock.block 


public methods | 
© createTables : cb 
© removeTables : cb 
© objectNormalize : account 
© toDB : raw 
© get : filter, fields, cb 
© set : address, fields, cb 
© remove : address, cb 


copyright (c) imfly 2016.06.23 http://ebookchain.org 


13-1 modules/accounts.js 类 图 及 其 关联 关系 


3. 流 程 


网 


因为 此 处 的 逻辑 并 不 复杂 ， 其 本 质 就 是 一 种 交易 ， 所 以 ， 请 参看 15.3.4 节 中 提供 的 流程 图 。 


13.2 解读 


计算 机 软件 是 对 人 类 活动 的 模拟 和 程序 化 ， 也 就 是 大 家 所 谓 的 “虚拟 化 ”。 在 设计 的 时 候 ， 都 会 设想 一 个 角色 (role) 来 代替 人 类 ， 并 负责 完成 所 要 开发 的 各 类 操作 。 这 个 角色 ， 通 常 在 开发 中 被 定义 
为 用 户 (user) ， 用 户 看 到 并 可 进行 操作 的 就 是 用 户 账号 ， 在 此 基础 上 ， 才 能 进行 权限 认证 ， 记 录 和 管理 与 用 户 有 关 的 各 类 操作 。 


比特 币 里 的 用 户 角 色 只 是 一 个 比特 币 地址 ， 该 地 址 是 通过 Hash 算 法 进行 加 密 处 理 的 字符 串 ， 因 此 称 为 Hash 地 址 。 同 时 ， 基 于 真实 网 络 的 复杂 性 ， 对 于 IP 地 址 的 追踪 比较 困难 ， 又 没有 其 他 暴露 用 户 信 
息 的 机 会 ， 所 以 比特 币 的 匿名 性 很 好 。 


亿 书 作为 一 款 加 密 货 币 产品 ， 自 然 也 提供 了 类 似 的 Hash 地 址 。 并 基于 该 地 址 ， 扩 展 提供 了 其 他 功能 ， 比 如 “别名 地 址 ”， 具 体 原 因 如 下 。 


1) 本 质 需 要 。 作 为 一 款 版 权 保护 应 用 ， 必 然 要 明确 版 权 所 有 人 、 实 名 信息 是 最 基本 的 要 求 ， 如 果 再 进行 完全 的 匿名 操作 ， 显 然 有 点 不 合适 ， 与 自己 的 目标 也 不 相符 。 当 然 ， 普 通 阅读 用 户 不 需要 实名 ， 
亿 书 允许 保持 足够 的 匿名 性 。 


2) 用 户 需 要 。 复 杂 的 字符 串 地 址 不 适合 人 类 记忆 ， 很 多 人 在 最 初 接触 比特 币 的 时 候 非 常 不 习惯 ， 经 常 混淆 或 忘记 自己 的 比特 币 地 址 ， 这 就 是 很 好 的 证 明 。 


3) 产品 需要 。 说 到 交互 功能 ， 比 特 币 除了 交易 之 外 ， 是 没有 什么 交互 的 。 而 作为 面向 普通 用 户 的 亿 书 ， 要 提供 基本 的 写作 、 团 队 协作 、 自 出 版 等 极 具 个 性 化 特点 的 功能 ， 交 互 功 能 被 置 于 突出 位 置 ， 因 
此 充满 个 性 化 的 用 户 名 是 必需 的 。 


具体 操作 时 ， 可 以 实现 如 下 的 需求 ， 详 见 亿 书 白皮书 (http://ebookchain.org/ebookchain.pdf) : 


“ 用户 可 以 注册 一 个 用 户 名 ， 它 相当 于 是 用 户 账 户 的 一 个 别名 。 


: 用户 名 都 是 唯一 的 。 


“ 注册 后 无 法 更 改 或 删除 。 


“用户 名 可 作为 支付 地 址 ， 所 以 称 为 别名 地 址 ， 类 似 于 人 们 常用 的 支付 宝 账号 ， 其 他 用 户 可 以 直接 向 该 用 户 的 用 户 名 付款 ， 用 户 不 再 需要 记 下 一 长 串 的 加 密 货币 地 址 。 


“用户 可 以 维护 一 个 联系 人 列表 。 


“ 这 些 操作 和 信息 ， 都 可 以 在 客户 端 里 完成 ， 如 图 13-2 所 示 。 


13.2.1 公共 API 


下 面 来 看 看 modules/accounts.js 368 行 处 的 代码 ， 具 体 如 下 : 


// 368 行 
router.map (shared, { 
"post /open": "open", 


"get /getBalance": "getBalance", 
"get /getPublicKey": "getPublickey", 
"post /generatePublicKey": "generatePublickey", 
"get /delegates": "getDelegates", 
"get /delegates/fee": "getDelegatesFee", 
"put /delegates": "addDelegates", 
"get /username/ge "getUsername", 
"get /username/fee": "getUsernameFee", 
"put /username": "addUsername", 
"get /": "getAccount™ 

])3 


// 439 行 
library.network.app.use('/api/accounts', router); 


个 人 信息 
请 填写 您 的 用 户 名 


13-2 客户 端 用 户 名 注册 界面 


取消 保存 名 称 


第 12 章 中 已 经 分 析 过 ， 这 里 的 router 是 helpers/routerjs 的 一 个 实例 。 上 述 代码 最 终 会 在 439 行 处 的 调用 中 映射 为 公共 AP1， 并 分 别 对 应 shared 中 的 方法 ， 例 如 : 


// accounts 
get /api/accounts/ -> shared.getAccount // 账号 


tt 
局 


post /api/accounts/open -> shared.open // 登录 

get /api/accounts/getBalance -> shared.getBalance 

get /api/accounts/getPublicKey -> shared.getPublickey 

Post /api/accounts/generatePublicKey -> shared.generatePublickey 


// username 

get /api/accounts/username/get -> shared.getUsername 

get /api/accounts/username/fee -> shared.getUsernameFee 

put /api/accounts/username -> shared.addUsername // 注册 用 户 名 


// delegates 

get /api/accounts/delegates -> shared.getDelegates 

get /api/accounts/delegates/fee -> shared.getDelegatesFee 
put /api/accounts/delegates -> shared.addDelegates 


// count 对 应 431 行 单独 定义 
get /api/accounts/count -> privated.accounts 


// 另外 两 个 是 在 debug 或 top 环 境 下 调试 用 的 ， 暂 且 不 表 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


这 里 先 暂 且 不 提 delegates (受托 人 ) 的 API 以 及 后 面 debug 环 境 下 的 API。 通 盘 浏 览 这 些 公 开 接 口 信息 可 以 知道 ， 能 够 直接 获取 的 信息 主要 包括 余额 (balance) 、 公 钥 (publicKey) 、 用 户 名 
(username) 及 修改 用 户 名 所 要 花费 的 费用 (fee) ， 以 及 受托 人 及 其 费用 等 信息 。 可 以 产生 公 铀 和 添加 用 户 名 ， 但 是 没有 删除 和 修改 用 户 名 的 功能 ， 所 以 一 旦 注册 了 用 户 名 ， 若 想 要 修改 用 户 名 信息 ， 则 


能 重新 再 注册 一 个 。 


比特 币 地 址 是 使 用 前 缀 来 进行 区 分 的 ， 比 如 : 1 开头 的 地 址 就 是 我 们 实际 使 用 的 地 址 ，3 开 头 的 地 址 是 测试 地 址 等 。 而 亿 书 则 是 使 用 后 缀 来 进行 区 分 的 ， 通 常 以 L 结 尾 。 代 码 在 modules/accounts.js 文 件 
里 ,摘录 如 下 : 


// 455 行 
Accounts .prototype.generateAddressByPublicKey = function (publicKey) { 
Var publicKeyHash = crypto.createHash ('sha256') .update (publicKey, 'hex') .digest (); 
Var temp = new Buffer (8); 
for (var i = 0; i < 8; i++) { 
temp[i] = publicKeyHash[7 - i]; 
} 


Var address = bignum.fromBuffer (temp) .toString() + 'L'; 
if (!address) { 
throw ETrTrOor ("wrong PublicKey " + PublicKey); 
} 
return address; 


另 一 个 类 似 的 地 址 ， 就 是 区 块 链 的 以 C 结 尾 的 块 地 址 ， 用 来 标注 generatorld， 代 码 与 上 面 的 基本 一 致 : 


// logic/block.js 20 行 
privated.getAddressByPublicKey = function (PublicKey) { 
Var publicKeyHash = crypto.createHash('sha256') .update (publicKey, 'hex') .digest (); 
Var temp = new Buffer (8); 
for (var i = 0; i < 8; i++) { 
temp[i] = PublicKeyHash[7 - i]; 
} 


var address = bignum.fromBuffer (temp) .toString () + "C"; 
return address; 


bE: 


// 上 面 的 方法 将 在 312 行 doRead 函 数 里 调用 
generatorId: privated.getAddressByPublicKey (raw.b_generatorPublickey), 


13.2.3 ”别名 地 址 


名 相当 于 地 址 别名 ， 就 像 支付 宝 账号 一 样 ， 所 以 白皮书 将 其 称 为 “别名 地 址 ”。 我 们 知道 ， 只 有 在 转移 支付 的 时 候 才 会 用 到 地 址 (接受 地 址 和 发 送 地 址 ) ， 所 以 要 体现 把 用 户 名 当 作 “别名 地 
址 ”的 逻辑 代码 ， 自 然 应 该 写 进 处 理 “资金 转 移 ”的 交易 代码 里 ， 下 面 来 看 看 modules/transactionsjs 文 件 ， 具 体 代码 如 下 : 


// modules/transactions.js 文件 
// 652 行 
shared.addTransactions = function (req, cb) { 
Var body = req.body; 
library.scheme.validate (body, { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


}, 
// 685 行 
required: ["secret", "amount", "recipientId"] 
}, function (err) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


// 702 行 
var isAddress = /^[0-9]+[L|1]$/g; 
if (isAddress.test (body.recipientId)) { 
query.address = body.recipientId; 
} else { 
query.username = body.recipientId; 


} 


library.balancesSequence.add (function (cb) { 
modules.accounts.getAccount (query, function (err, recipient) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
// 717 行 下 
Var recipientId = recipient ? recipient.address : body.recipientId; 
Var recipientUsername = recipient ? recipient.username : null; 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


try { 
Var transaction = library.logic.transaction.create ({ 
// 764 行 
type: TransactionTypes.SEND, 
amount: body.amount, 
sender: account, 
recipientId: recipientId, 
recipientUsername: recipientUsername, 
keypair: keypair, 
requester: keypair, 
secondKeypair: secondKeypair 
]); 
} catch (e) { 
return cb (e.toString () )， 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


上 述 代 码 实现 的 就 是 资金 转账 的 功能 (后台 编码 的 交易 类 型 为 TransactionTypes.SEND， 见 764 行 处 的 代码 ) ， 毫 无 疑问 ， 必 须 提 供 三 个 参数 secret、amount 和 recipientld ( 见 685 行 处 的 代码 ) 。 从 


一 


702 行 处 的 代码 可 知 ， 其 中 recipientld 可 以 是 字符 串 地 址 ， 也 可 以 是 用 户 名 。 从 764 行 以 后 的 代码 还 可 以 了 解 到 ， 交 易 时 的 recipientld 和 recipientUsername 字 段 都 保存 在 数据 库 里 了 。 


13.2.4 注册 用 户 名 


亿 书 默认 不 提供 别名 地 址 ， 需 要 用 户 注册 。 从 上 面 的 API 很 容易 就 能 找到 “注册 用 户 名 ”的 源码 方法 shared.addUsername， 具 体 代 码 如 下 : 


// 868 行 
shared.addUsername = function (req, cb) { 
Var body = req.body; 
library.scheme.validate (body, { 
type: "object", 
properties: { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
}, 


// 890 行 
required: ['secret', 'username'] 
}, function (err) { 
// 896 行 


Var hash = crypto.createHash('sha256') .update (body.secret, 'utf8').digest (); 
Var keypair = ed.MakeKeypair (hash); 


if (body.publicKey) { 
if (keypair.publicKey.toString('hex') != body.publicKey) { 
return cb ("Invalid passphrase"); 
} 
} 


library.balancesSequence.add (function (cb) { 
if (body.multisigAccountPublicKey && body.multisigAccountPublicKey != keypair.publicKey.toString('hex')) { 
modules.accounts.getAccount ({publicKey: body.multisigAccountPublicKey}, function (err, account) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


modules.accounts.getAccount ({publicKey: keypair.publicKey}, function (err, requester) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


try { 
// 949 行 
Var transaction = library.logic.transaction.create ({ 
type: TransactionTypes .USERNAME, 
username: body.username, 
sender: account, 
keypair: keypair, 
secondKeypair: secondKeypair, 
requester: keypair 
}); 
} catch (e) { 
return cbl(e.toString()); 
} 
modules .transactions.receiveTransactions ([transaction], cb); 
])3 
is 
jelas 
self.getAccount ({publicKey: keypair.publicKey.toString('hex')}, function (err, account) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
try { 
// 984 行 


Var transaction = library.logic.transaction.create ({ 
type: TransactionTypes .USERNAME, 
username: body.username, 
sender: account, 
keypair: keypair, 
secondKeypair: secondKeypair 


])3 
} catch (e) { 
return cbl(e.toString()); 


} 


modules .transactions .receliveTransactions ([transaction], cb); 


]); 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


分 析 949 行 和 984 行 处 的 代码 ， 可 以 了 解 到 ， 所 谓 的 注册 
明文 密码 (secret) 和 用 户 名 (username) 。 


13.2.5 ”联系 人 列表 


户 名 ， 实 质 上 就 是 用 户 提交 了 一 个 TransactionTypes.USERNAME 类 型 的 交易 。890 行 处 的 代码 ， 说 明 该 API 必 须 包含 两 个 参数 ， 


亿 书 具 备 社交 功能 ， 因 此 其 维护 了 一 个 联系 人 列表 。 与 传统 中 心 化 软件 不 同 的 是 ， 区 块 链 产品 里 处 处 都 是 交易 ， 关注 其 他 用 户 的 行为 也 是 一 项 交易 (内 部 的 交易 类 型 为 


TransactionTypes.FOLLOW) 。 


这 项 功能 的 源码 在 文件 nodules/contacts,js 里 ， 其 类 医 


及 关联 关系 如 


13-3 所 示 。 


户 要 提供 


口 modules: 0 
O library: 0 


Private methods- 


public methods 
© checkContacts: (publicKey, contacts, cb) 
© checkUnconfirmedContacts: (publicKey contacts, cb) 
© sandboxApi: (call, args, cb) 


© getUnconfirmedContacts: (req, cb) 
© getContacts: (req, cb) 

© addContact: (req, cb) 

© getFee: (req, cb) 


copyright (c) imfly 2016.06.23 http://ebookchain.org 


图 13-3 modules/contacts.js 类 图 及 其 关联 关系 


与 其 他 模块 文件 一 样 ， 我 们 可 以 非常 清晰 地 看 到 该 文件 提供 的 公共 AP1， 具 体 代 码 如 下 : 


// modules/contacts.js 文 件 
// 198 行 
router.map (shared, { 
"get /unconfirmed": "getUnconfirmedContacts", 
"get /": "getContacts", 
"put /": "addContact", 
"get /fee": "getFee" 


这 些 API 很 简单 ， 这 


点 关注 其 中 的 两 个 API: 


put /api/contacts -> shared.addContact // 添加 关注 功能 
get /api/contacts -> shared.getContacts // 获得 列表 


对 应 方法 的 源码 具体 如 下 : 


// 406 行 
shared.addContact = function (req, cb) { 
Var body = req.body; 
library.scheme.validate (body, { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
// 431 行 
required: ["secret", "following"] 
}, function (err) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


// 448 行 
Var followingAddress = body.following.substring(1, body.following.length); 
var isAddress = /^[0-9]+[L|1]$/g; 
if (isAddress.test (followingAddress)) { 
query.address = followingAddress:; 
} else { 
query.username = followingAddress; 


library.balancesSequence.add (function (cb) { 
if (body.multisigAccountPublicKey && body.multisigAccountPublicKey != keypair.publicKey.toString('hex')) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
try { 
Var transaction = library.logic.transaction.create ({ 
type: TransactionTypes .FOLLOW 
sender: account, 
keypair: keypair, 
secondKeypair: secondKeypair, 
contactAddress: followingaddress，// 511 行 
requester: keypair 
1)s 
} catch (e) { 
return cble.toString()); 
} 
modules .transactions.receiveTransactions ([transaction], cb); 
js 
D); 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


431 行 处 的 代码 ， 添 加 关注 需要 两 个 参数 secret 和 following， 这 里 following 其 实 就 是 用 户 的 账号 地 址 或 用 户 名 ( 见 448 行 处 的 代码 ) 。 然 后 ， 经 过 一 系列 的 验证 之 后 ， 写 入 数据 库 的 contactAddress 字 
段 ( 见 511 行 处 的 代码 ) ， 一 个 关注 的 操作 过 程 就 完成 了 。 


然后 ， 用 户 通过 客户 端 浏 览 自己 的 联系 人 列表 ， 需 要 用 到 另 一 个 API， 对 应 的 方法 是 shared.getContacts， 有 具体 代码 如 下 : 


shared.getContacts = function (req cb) { 
// 362 行 
modules .accounts.getaAccount ({address: query.address}, function (err, account) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


async.series ({ 
contacts: function (cb) { 
/A372 行 
if (!account.contacts .Length) { 
return cb (nul1，[])， 
} 
modules.accounts.getAccounts ({address: {$in: account.contacts}}, ["address", "username"], cb); 
] 
followers: function (cb) { 
if (!account .followers.length) { 
return cb (nul1，[])， 


modules .accounts .getAccounts ({address: {$in: account.followers}}, ["address", "username"], cb):; 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
1); 
]); 
]); 


这 段 代 码 最 重要 的 部 分 就 是 362 行 处 nodules.accounts.getAccount 方 法 的 调用 ， 此 处 获得 了 对 应 地 址 的 用 户 账号 (account) 实例 ， 联 系 人 都 保存 在 该 实例 的 account.contacts 生 


UL 


13.3 总 结 


VGN= 口 


读 完 代码 可 以 发 现 ， 代 码 的 逻辑 其 实 非常 简单 ， 仅 仅 相当 于 两 个 基本 功能 ， 一 个 是 生成 加 密 货币 的 Hash 地 址 ， 另 一 个 是 通过 交易 模块 扩展 和 关联 其 他 功能 。 其 中 ，Hash 地 址 是 基础 ， 在 整个 亿 书 的 开 
发 设计 中 ，Hash 地 址 无 处 不 在 ， 签 名 、 验 证 和 交易 ， 以 及 区 块 链 等 都 需要 它 。 与 地 址 结合 最 为 紧密 的 ， 就 是 接 下 来 将 要 介绍 的 签名 ( 见 第 14 章 ) 。 


13.4 参考 


亿 书 白皮书 : http://ebookchain.org/ebookchain.pdf 


第 14 章 ”签名 和 多 重 签名 


在 现实 世界 里 ， 个 人 签名 是 确认 资产 所 属 的 基本 手段 之 一 。 随 着 区 块 链 等 相关 技术 的 创新 和 突破 ， 很 多 有 形 或 无 形 的 资产 都 将 实现 去 中 心 化 ， 数 字 资 产 将 无 处 不 在 。 那 么 对 于 数字 资产 ， 确 认 其 所 属 的 
技术 手段 就 是 本 章 所 要 介绍 的 数字 签名 (非特 殊 说 明 ， 本 书 所 提 到 的 签名 都 是 指数 字 签名 ) 。 而 多 重 签名 是 对 签名 的 扩展 使 用 ， 为 数字 资产 的 转移 提供 了 安全 保障 和 技术 手段 。 本 章 将 从 基本 概念 入 手 ， 详 
细 介 绍 签名 和 多 重 签名 的 作用 和 代码 实现 。 


14.1 源码 


本 章 所 涉及 的 主要 源码 地 址 具体 如 下 。 


signatures,js: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/modules/signatures.js 


multisignatures.js: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/modules/multisignatures.js 


14.2 解读 


14.2.1 签名 


1. 签 名 的 作用 和 特点 


1) 名 字 的 解释 。 签 名 是 什么 ”很 多 人 的 第 一 反应 是 日 常生 活 中 用 笔 进行 的 签名 ， 这 种 直觉 是 对 的 。 不 过 ， 当 大 家 看 到 网 上 给 出 的 解释 ， 很 多 人 又 会 感到 困惑 了 ， 其 似乎 与 我 们 所 知 的 签名 相去 甚 远 。 
实 上 ， 不 同 的 概念 在 不 同 领域 的 表述 是 有 差别 的 ， 但 本 质 基本 相同 。 笔 者 坚信 生活 是 一 切 创作 的 源泉 ， 任 何 一 个 概念 都 能 从 生活 中 找到 原型 ， 这 里 的 “签名 ”也 是 如 此 。 所 以 ， 引 用 百科 上 的 解释 ， 签 名 
( 实 为 数字 签名 ) 就 是 只 有 信息 的 发 送 者 才能 产生 的 别人 无 法 伪造 的 一 段 数字 串 


Po 


TT 
| 


2) 签名 的 作用 。 日 常生 活 中 ， 凡 是 需要 确认 归属 的 (是 


属于 签名 人 的 ， 而 不 是 其 他 人 的 ) ， 都 需要 所 有 者 进行 签名 。 比 如 ， 我 签 了 一 份 文 件 ， 若 文件 出 了 问题 ， 那 么 责任 就 要 由 我 来 承担 ; 我 签 了 一 个 
支票 ， 就 代表 将 由 我 来 支付 支票 上 的 金额 。 大 家 日 常 中 最 常见 的 场景 就 是 去 银行 办 业务 ， 银 行 职员 会 让 你 反复 签 一 大 堆 的 单据 ， 想 必 每 个 人 对 此 都 会 有 深刻 的 印象 。 


3) 签名 的 特点 。 人 的 笔迹 是 极 具 个 性 化 的 ， 越 熟练 的 字体 ， 个 性 特征 越 固 定 ， 
一 来 ， 人 的 签名 就 具有 唯一 性 、 可 验证 性 的 特点 ， 并 被 法 律 所 认可 。 


此 对 于 一 个 人 的 名 字 ， 不 同 的 人 写 出 完全 相同 笔迹 的 概率 会 非常 小 ， 即 便 是 专业 的 模仿 也 可 以 通过 技术 鉴别 出 来 ， 这 样 


4) 签名 的 验证 。 如 果 你 拿 着 一 张 支票 去 银行 兑换 ， 银 行 职 员 会 仔细 比 对 支票 上 的 签名 和 印章 ， 确 保 付款 人 的 签名 ， 以 及 印章 的 大 小 、 样 式 等 ， 与 银行 留存 的 信息 完全 一 致 ， 只 有 完全 吻合 才 会 允许 竞 
付 ， 这 就 是 签名 的 验证 。 


2. 比 特 币 客户 端 签名 功能 


数字 资产 也 需要 签名 。 类 比 人 类 签名 ， 比 特 币 也 有 签名 的 功能 。 如 果 了 解 比特 币 钱包 ( 客 
名 和 验证 。 笔 者 个 人 使 用 的 是 比特 币 官方 网 站 提供 的 比 太 钱包 ， 如 图 14-1 所 示 。 


户 端 软 件 ) ， 就 会 发 现 它 提供 了 一 个 签名 消息 的 功能 ， 可 以 用 来 对 其 他 用 户 通过 比特 币 网 络 之 外 的 信息 进行 签 


验证 消息 签名 


图 14-1 比 太 钱包 签名 消息 和 验证 消息 签名 界面 


这 个 功能 是 做 什么 用 的 呢 ? 很 多 人 对 此 还 不 太 清楚 ， 下 面 就 来 举 个 简单 的 例子 解释 一 下 。 注 意 ， 具 体 使 


的 时 候 绝 不 限于 这 些 应 用 。Alice 开 了 一 个 网 店 ， 但 没有 直接 接 入 比特 币 网 络 ， 不 能 自动 确认 和 


验证 支付 者 。 客 户 Imfly 购 买 了 她 的 产品 ， 并 | 


传 给 Alice，Alice 使 


想象 一 下 ， 如 果 没有 签名 功能 会 怎么 样 呢 ? 
世界 里 ， 这 个 问题 是 通过 运营 平台 这 个 第 三 方 达成 的 〈 比 讽 


牺牲 个 人 信息 安全 获得 交易 的 基本 保障 。 


比特 币 支付 了 全 部 货款 。 
能 发 货 。 这 时 候 就 需要 Imfly 先 把 支付 货款 的 比特 币 地 址 和 相关 交易 信息 进行 签名 (如 图 14-1 所 示 的 第 2 步 将 会 生成 一 个 签名 字符 串 ) 通过 QQ 或 邮件 把 比特 
能 确认 交易 确实 是 Imfly 的 。 


客户 端 验证 信息 签名 ， 就 


为 比特 币 地 


因为 比特 币 仅 是 一 个 匿名 的 、 安 全 的 支付 手段 ， 但 是 无 法 确认 支付 方 或 收 款 方 是 谁 ， 信 息 的 不 确定 性 ， 


、 安 全 且 可 验证 。 把 这 个 概念 抽象 出 来 ， 应 


是 确定 资产 所 属 ， 其 特征 是 简 


[支付 宝 等 平台 ) ， 和 平台 必须 掌握 双方 的 全 部 信息 ， 任 何 一 方 出 现 欺诈 ， 都 需要 通过 向 平台 投诉 来 解决 。 


到 计算 机 系统 里 ， 那 就 是 为 了 确定 数字 资产 所 


止 和 交易 都 是 公开 匿名 的 ， 为 了 防止 冒充 冒 领 ，Alice 需 要 确认 Imfly 提 供 的 那个 付款 地 址 确实 是 Imfly 本 人 的 ， 否 则 就 不 
地址、 交易 信息 ， 以 及 生成 的 签名 字符 


一 并 


将 使 得 比特 币 网 络 之 外 的 交易 无 法 达成 。 在 中 心 化 的 


需要 对 第 三 方 平台 绝对 信任 ， 并 通过 


通过 上 述 分 析 ， 可 以 理解 的 是 ， 签 名 的 作 
常 看 到 的 “数字 签名 ”的 概念 。 


在 网 络 世界 里 ， 签 名 可 以 对 任何 需要 确认 的 数字 资产 进行 处 理 ， 比 如 比特 币 地 址 、 电 子 书 版 权 等 ， 并 以 此 来 宣告 


在 具体 的 开发 设计 中 ， 就 是 


加 密 技术 代 蔡 人 的 笔迹 来 进行 签名 ， 不 然 任何 签名 方法 都 会 被 模仿 ， 而 且 模 仿 的 成 本 极 低 ， 相 


一 ， 各 大 平台 仅仅 通过 用 户 权限 来 限制 用 户 使 


12 章 。 


属 ， 也 需要 进行 签名 ， 这 就 是 大 


要 资产 的 所 属 ， 这 让 无 须 监管 的 去 中 心 化 交易 成 为 可 


反 ， 验 证 的 成 本 却 很 高 。 这 也 是 当前 数字 出 版 行业 版 权 保护 不 力 的 原 


因 之 


数字 出 版 物 ， 并 没有 对 出 版 物 本 身 采 取 数 字 签名 等 加 密 措施 ， 一 旦 被 盗版 ， 验 证 和 取证 的 工作 将 会 耗费 大 量 的 人 力 物 力 。 具 体 的 加 密 或 验证 技术 ， 请 参考 第 


亿 书 也 具备 签名 功能 ， 只 不 过 目前 没有 单独 为 


户 账号 资产 追加 了 一 层 保护 。 


户 提 供 签名 信息 的 操作 ， 而 是 通过 签名 添加 了 支付 密码 的 功能 ， 对 


版 物 自动 追加 数字 签名 或 电子 印章 ， 并 保存 到 


区 块 链 。 


4. 亿 书 的 支付 密码 


山 
位 
四 | 


及 关联 关系 如 轿 


14-2 所 示 。 


签名 方法 在 modules/signatures.js 文 件 里 


下 面 还 是 从 API 开 始 ， 代 码 如 下 : 


对 


后 续 还 会 扩展 更 多 的 功能 ， 


户 发 布 的 任何 数字 出 


// modules/signatures.js 文 件 
// 179 行 
router.map (shared, { 
"get /fee": "getFee", 
"put /": "addSignature" 
]); 


// 188 行 


library.network.app.use('/api/signatures', router); 


通过 上 面 的 代码 ， 可 以 了 解 签名 提供 了 两 个 简单 的 公共 接口 : 


DO modules: 0 
D library: 0 


© getFee : (req, cb) 
@ addSignature : (req, cb) 


Wh 


NE 


CT 
EE 


copyright (c) imfly 2016.06.26 http://ebookchain.org 


图 14-2 ”modules/signatures.js 类 区 


get /api/signatures/fee -> shared.getFee 
put /api/signatures/ -> shared.addSignature // 签名 操作 


© create ; (data, trs) 

© calculateFee ; (trs sender) 

© verify : (trs sender, cb) 

® process ; (trs sender, cb) 

© getBytes : (trs) 

© apply : (trs block sender, cb) 

® Undo : (trs block sender, cb) 

© applyUnconfirmed : (trs, sender, cb) 
© undoUnconfirmed ; (trs, sender, cb) 
© objectNormalize : (trs) 

© dbRead : (raw) 

© dbSave : (trs, cb) 

© ready : (trs, sender) 


显然 ， 最 核心 的 方法 就 是 shared.addSignature， 代 码 如 下 : 


/7 215 行 
shared.addSignature = function (req, cb) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
library.scheme.validate (body, { i 
properties: { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


’ 
required: ["secret", "secondSecret"] 

}, function (err) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


library.balancesSequence.add (function (cb) { 
if (body.multisigAccountPublicKey && body.multisigAccountPublicKey != keypair.publicKey.toString('hex')) { 
modules.accounts.getAccount ({publicKey: body.multisigAccountPublicKey}, function (err, account) 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


trey 计 
Y Var transaction = library.logic.transaction.create ({ 
type: TransactionTypes.SIGNATURE, // 297 行 
sender: account, 
keypair: keypair, 
requester: keypair, 
secondKeypair: secondKeypair, 
}); 
} catch (e) { 
return cb (e.toString () ); 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


毫 无 疑问 ， 签 名 也 是 一 个 简单 的 交易 (交易 类 型 为 TransactionTypes.SIGNATURE， 见 297 行 处 的 代码 ) 。 基 于 此 ， 我 们 不 难 想象 ， 添 加 类 似 比特 


书 的 下 一 个 版 本 里 添加 这 项 功能 ， 具 体 请 关注 亿 书 币 版 本 库 (https://github.com/ebookcoin/ebookcoin) 的 最 新 进展 。 


14.2.2 ”多 重 签名 


金 ， 通 常 需要 该 地 址 的 所 有 人 使 用 他 的 私 钥 (由 用 户 保护 ) 进行 签名 。 那 么 ， 多 重 签名 就 是 指 动用 这 笔 资金 需要 多 个 私 钥 签 名 ， 通 常 这 笔 资金 或 数字 资产 会 保存 在 一 个 多 重 签名 的 地 址 或 账号 里 (就 比特 币 
而 言 ， 名 地 址 以 3 开头 ) 。 这 就 好 比 在 工作 中 有 一 份 文 件 ， 需 要 多 个 部 门 签署 才能 生效 一 样 。 


6 的 签名 功能 也 是 一 件 非常 简单 的 事情 ， 我 们 会 在 亿 


上 文中 提 到 过 ， 比 特 币 的 匿名 性 ， 使 交易 处 于 不 可 信 状 态 ， 最 终 将 导致 用 户 不 敢 交 易 。 有 了 签名 功能 ,就 有 了 确认 双方 信息 的 有 效 手段 ， 问 题 总 算 有 了 一 个 解决 方案 。 聪 明 的 小 伙伴 会 发 现 ， 签 名 和 验 
证 过 程 除了 烦琐 之 外 ， 并 没有 让 我 们 觉得 比 使 用 第 三 方 平 台 更 有 效 、 更 安全 。 那 么 ， 还 有 没有 更 好 的 解决 方案 呢 ? 回答 是 : 有 ， 那 就 是 多 重 签名 。 


多 重 签名 ， 可 以 简单 地 理解 为 一 个 数字 资产 的 多 个 签名 。 签 名 标定 的 是 数字 资产 的 所 属 和 权限 ， 多 重 签名 预示 着 数字 资产 可 由 多 人 支配 和 管理 。 在 加 密 货 币 领域 ， 如 果 要 动用 一 个 加 密 货 币 地 址 的 资 


在 实际 的 操作 过 程 中 ， 一 个 多 重 签名 地 址 可 以 关联 n 个 私 铀 ， 在 需要 转账 等 操作 时 ， 只 要 其 中 的 m 个 私 钥 签名 就 可 以 把 资金 转移 了 ， 其 中 m 要 小 


3/5， 等 等 ， 这 一 点 是 要 在 建立 这 个 多 重 签名 地 址 的 时 候 就 确定 好 的 。 


2 


化 
Do 


子 。 


作 原 理 


等 


n， 也 就 是 说 ，m/n 要 小 于 等 于 1， 可 以 是 2/3、 


数字 资产 在 某 种 情况 下 ， 需 要 多 人 支配 。 换 句 话说 ， 在 某 些 特定 条 件 下 ， 数 字 资 产 如 果 无 法 确认 其 归属 于 某 个 特定 的 人 ， 那 么 最 好 是 让 相关 的 人 共同 签署 它 的 所 有 权 。 


仍然 以 上 面 的 例子 进行 说 明 ， 在 Alice 发 货 之 后 Imfly 收 到 货 之 前 ， 这 笔 钱 应 该 由 第 三 方 信用 比较 高 的 中 介 和 暂时 保存 ， 在 这 个 阶段 ， 这 笔 钱 要 么 是 Alice 的 ， 要 么 是 Imfly 的 ， 最 终 的 归属 要 看 Imfly 是 否 收 到 
所 以 ， 这 个 第 三 方 无 论 如 何 都 是 应 该 有 的 ， 不 然 Imfly 就 要 承担 大 部 分 风险 (因为 比特 币 具 有 单 向 不 可 逆 性 ，Imfly 发 送 之 后 就 没有 办 法 再 收回 了 ) 。 


这 样 一 来 ， 这 笔 钱 的 所 属 关系 在 交易 过 程 中 就 会 涉及 Alice、Imfly 和 第 三 方 平 台 (虽然 不 属于 它 ， 但 它 有 权 裁定 资金 的 去 向 ) ， 那 么 就 应 该 由 他 们 三 方 共同 签名 ， 因 此 网 上 购物 就 是 典型 的 多 重 签名 的 例 


其 多 重 签名 模型 就 是 2/3， 也 就 是 说 ， 只 要 他 们 中 的 两 方 签 了 名 ， 资 金 就 可 以 被 转移 。 


方 平台 调查 之 后 ， 通 过 签名 就 能 把 这 笔 钱 转 给 Alice 或 退回 Imfly。 


和 卖方 三 方 存在 。 与 传统 的 淘宝 和 京东 模式 相 比 ， 基 于 区 块 链 技术 的 多 重 签名 模式 更 加 便捷 和 安全 ， 至 少 不 用 担心 第 三 方 倒闭 、 挪 用 资金 或 携 款 外 逃 。 


3. 应 


具体 到 这 个 例子 ，Imfly 把 钱 打 给 一 个 关联 三 方 私 钥 的 多 重 签名 地 址 ， 如 果 整 个 交易 过 程 顺利 ， 只 要 Alice 和 Imfly 两 个 签名 ， 这 笔 钱 就 会 顺利 到 达 Alice 手 里 。 如 果 不 顺 利 ， 他 们 任何 一 人 提出 仲裁 ， 第 三 


这 里 需要 重点 提示 的 是 ， 淘 宝 、 京 东 等 电子 商务 网 站 包括 了 网 站 自身 、 买 卖 双 方 和 支付 平台 ， 其 实 是 4 方 共存 的 ， 而 这 里 多 重 签名 的 解决 方案 中 ， 支 付 平 台 完全 被 加 密 货币 所 取代 ， 因 此 只 有 网 站 、 买 方 


用 场景 


很 显然 ， 多 重 签名 给 了 加 密 货币 腾飞 的 翅膀 ， 让 它 单一 、 单 向 支付 的 能 力 更 具 吸引 力 ， 让 区 块 链 技术 应 用 到 各 行 各 业 成 为 可 能 。 下 面 简单 罗列 几 个 应 


场景 ， 以 供 探索 和 思考 。 


“ 电子 商务 。 比 较 常 见 的 是 2/3 的 模式 。 上 面 所 列举 的 电子 商务 网 站 的 例子 ， 就 是 最 典型 的 场景 之 一 ， 目 前 已 经 有 成 功 的 案例 了 。 延 伸 一 下 ， 这 类 应 用 的 本 质 就 是 中 介 ， 所 以 其 还 可 用 于 各 类 中 介 机 构 性 
质 的 服务 上 。 


“ 财产 分 割 。 比 如 夫妻 双方 的 共有 财产 ， 可 以 使 用 1/2 的 模式 ， 一 个 账户 谁 都 可 以 使 用 ， 跟 各 自 拥有 账号 一 样 ， 好 处 是 系统 患 实地 记录 了 每 个 人 的 花 销 ， 必 要 的 时 候 很 容易 就 能 进行 清算 。 扩 展 到 公司 合 
伙 经 营 ， 也 可 以 使 用 1/n 的 模式 ，n 个 合伙 人 ， 都 可 以 直接 支配 共有 资金 ， 对 账 务 进行 具体 清算 时 ， 一 目 了 然 。 


: 资金 监管 。 其 实 ， 这 是 多 重 签名 的 最 直接 作用 ， 一 笔 钱 需要 多 个 人 签名 才能 使 用 ， 任 何 一 个 人 都 无 法 直接 动用 这 笔 资金 ， 这 在 生活 中 太 常 见 了 ， 只 要 灵活 设置 多 重 签名 的 比重 模式 ， 就 能 解决 生活 中 
的 很 多 问题 。 比 如 ， 还 是 以 夫妻 共同 财产 为 例 ， 夫 妻 要 储备 一 笔 资金 ， 供 孩子 上 大 学 使 用 ， 在 这 之 前 谁 都 不 能 动 ， 那 么 把 模式 改 为 2/2， 不 仅 限制 了 夫妻 双方 ， 也 给 黑客 攻击 增加 了 难度 。 


多 重 签名 的 设计 ， 让 各 种 业务 的 去 中 心 化 充满 了 无 限 可 能 。 


4. 亿 书 的 多 重 签名 


多 重 签名 方法 在 modules/multisignatures.js 文 件 里 ， 其 类 图 及 关联 关系 如 图 14-3 所 示 。 


© Multisignatures 
hi 4 
D library: 0 © create : (data, trs) 


© calculateFee : (trs, sender) 
@ attachApi: 0 © verify : (trs, eh 号 
public methods- library. logic.transaction.attachAssetType ee ‘os, ee 
© sandboxApi: (call, args, cb) © getBytes : (trs) 
SN ® apply : (trs block sender, cb) 


© undo : (trs, block sender, cb) 
© applyUnconfirmed : (trs, sender, cb) 
© undoUnconfirmed : (trs sender, cb) 
© getAccounts: (req, cb) © objectNormalize : (trs) 
© pending: (req cb) © dbRead ; (raw) 
© processSignature: (tx, cb) © dbSave : (trs cb) 
© sign: (req cb) © ready : (trs, sender) 
© addMultisignature: (req, cb) 
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图 14-3 ”modules/multisignatures.js 类 图 及 其 关联 关系 


实现 API 的 代码 如 下 : 


/7 A 

router.map (shared, { 
"get /pending": "pending", 
rpost /eign “sign 
"put /": "addMultisignature", 
"get /accounts": "getAccounts" 


]); 


1 了 0 
library.network.app.use('/api/multisignatures', router); 


解析 一 下 ， 最 后 产生 的 API 如 下 : 


get /api/multisignatures/pending -> shared.pending // 查询 等 待 中 的 交易 
post /api/multisignatures/sign -> shared.sign // 签名 交易 
put /api/multisignatures/ -> shared.addMultisignature // 创建 多 重 签名 账号 


get /api/multisignatures/accounts -> shared.getAccounts // 获得 关联 的 账号 (对 应 着 用 户 私 钥 ) 


提供 的 功能 也 很 明显 ， 包 括 待 交 易 查 询 、 关 联 账 号 列表 查询 、 用 户 签名 交易 和 创建 多 重 签名 账号 这 4 个 核心 功能 。 下 面 就 先 从 创建 多 重 签名 账号 开始 ， 这 个 API 使 用 的 是 HTTP 的 put 方 法 ， 对 应 的 自然 是 
更 新 操作 ， 不 查看 代码 也 可 以 猜想 得 到 ， 该 功能 应 该 是 在 已 有 账号 的 基础 上 进行 的 操作 ， 从 客户 端 钱包 的 设置 菜单 里 ， 可 以 看 到 如 图 14-4 所 示 的 操作 。 


再 叙述 。 


点 击 以 编辑 信息 
6722322622037743544L 


ee “在 此 帐户 开启 多 重 签名 


联系 人 


图 14-4” 亿 书 多 重 签名 设置 界面 


下 面 来 看 看 shared.addMultisignature 的 源 代码 ， 具 体 如 下 : 


// modules/multisignatures.js 文 件 
shared.addMultisignature = function (req, cb) { 
Var body = req.body:; 
library.scheme.validate (body, { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


32 行 
required: ['min', 'lifetime', 'keysgroup', 'secret'] 
}, function (err) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


library.balancesSequence.add (function (cb) { 
modules.accounts.getAccount ({publicKey: keypair.publicKey.toSstring('hex')}, function (err, account) { 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


// 767 行 
try { 

Var transaction = library.logic.transaction.create ({ 
type: TransactionTypes.MULTI，// 769 行 
sender: account, 
keypair: keypair, 
secondKeypair: secondKeypair, 
min: body.min, 
keysgroup: body.keysgroup, 
lifetime: body.lifetime 

])3 

下 Batch te} + 
return cb (e.toString () ); 


} 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


从 732 行 处 的 代码 可 知 ， 创 建 一 个 


经 过 一 系列 的 验证 之 后 ， 创 建 一 个 多 


如 果 用 户 同 意 交 易 ， 那 么 就 可 以 对 待 确认 的 交易 进行 签名 (shared.sign 方 法 ) ，shared.sign 方 法 的 源码 如 下 : 


// 586 行 
shared.sign = function (req, cb) { 
Var body = req.body:; 
library.scheme.validate (body, { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
required: ['transactionId', 'secret'] 
}, function (err) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


// 632 行 
function qdqone (cb) { 
library.balancesSequence.add (function (cb) { 
// 634 行 
Var transaction = modules.transactions.getUnconfirmedTransaction (body.transactionId); 


if (!transaction) { 
return cb ("Transaction not found"); 


} 


// 640 行 


名 交易 (交易 类 型 为 TransactionTypes.MULTI， 见 769 行 处 的 代码 ) 并 保存 到 数据 库 (区 块 链 ) 里 。 创 建成 功 的 账号 可 以 显示 多 
作 。 接 下 来 ， 自 然 应 该 能 够 查看 全 部 关联 的 账号 (请 看 shared.getAccounts 方 法 ) ， 以 及 查看 待 确 认 的 交易 (请 看 shared.pending 方 法 ) ， 这 两 个 方法 仅仅 是 简 重 


a 的 查询 ， 并 没有 什么 难度 ， 因 


此 这 号 


名 ， 必 须要 有 min、lifetime、keysgroup 和 secret 这 4 个 参数 (其 实 ， 还 有 一 个 默认 参数 就 是 当前 账号 ) ，min 代 表 上 文 所 讲 到 的 m 值 ， 即 需要 确认 的 人 数 ; 
lifetime 代 表 生 命 周期 keysgroup 包 含 乡 重 签名 关联 的 全 部 账号 ， 它 是 数组 类 型 ， 包 含 的 元 素 个 数 就 是 n; secret 是 用 户 密码 ， 与 用 户 私 钥 相 对 应 。 


账号 菜单 ， 对 交易 进行 操 


不 


transaction.signatures = transaction.signatures || []; 
transaction.signatures.push (sign); 


library.bus.message ('signature', { 


signature: sign, 


transaction: transaction.id 


}, true); 
cb (); 

}, function (err) { 
if (err) { 


return cb (err.toString()); 


} 


cb (nul1， 
]); 
} 


{transactionId: transaction.id}); 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


shared.sign 方 法 与 单独 的 签名 方法 的 不 同 之 处 是 ， 单 独 的 签名 方法 相当 了 


的 代码 维护 了 一 个 签名 数组 ，641 行 处 的 push 方 法 把 
解 本 章 所 讲 的 签名 方法 。 


总 结 


VGN= 口 


14.3 


在 加 密 货 币 里 ， 每 一 个 交易 都 会 涉及 使 用 私 钥 签 名 ， 
研究 一 下 亿 书 的 交易 了 ， 请 看 第 15 章 “交易 ”。 


第 15 章 交易 
我 们 前 面 说 过 ， 区 块 链 技 术 是 “利益 ”转移 规则 


加 密 解密 、P2P 网 络 、 区 块 链 等 一 系列 技术 都 是 车 


新 建 一 个 交易 ， 而 这 里 的 多 
户 签名 写 入 数组 ) 。 而 且 ， 相 比 独立 签名 ， 验 证 也 更 


签名 的 


杂 ， 我 们 将 在 第 15 


A, 


户 签名 方法 ， 显 然 仅仅 是 对 未 确认 的 交易 (634 行 处 的 代码 ) 进行 签名 确认 (640 行 处 
“交易 ”中 集中 讨论 验证 的 问题 。 您 也 可 以 结合 第 15 章 的 内 容 ， 阅 读 和 理 


于 确认 每 笔 资金 的 所 有 人 。 确 定 了 所 有 人 ， 自 然 就 确定 了 资金 转移 的 条 件 、 目 标 和 方向 ， 就 为 资金 的 转移 操作 黄 定 了 基础 。 很 自然 的 ， 接 下 来 该 


的 编码 技术 ， 其 核心 目标 是 保证 数字 财富 或 价值 能 够 安全 、 透 明 、 快 速 地 转移 。 
绕 交 易 来 展开 的 。 


此 ， 交 易 是 区 块 链 产品 中 最 本 


6 交易 的 概念 、 


为 了 表述 方便 ， 本 章 将 以 区 块 链 技术 的 典型 应 


加 密 货币 为 表述 对 象 ， 详 细 解 读 加 密 货 


并 对 在 第 13 章 和 第 14 章 里 故意 漏 掉 的 判断 逻辑 让 


15.1 ”源码 与 类 图 


1. 源 码 


本 章 所 涉及 的 主要 源码 地 址 具体 如 下 。 


transaction-types.js: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/helpers/transaction-types.js 


transaction.js: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/logic/transaction.js 


transactions.js: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/modules/transactions.js 


交易 的 类 图 及 其 关联 关系 如 图 15-1 所 示 。 


的 部 分 , 是 


区 块 链 产 品 的 核心 功能 ， 


本 质 和 生命 周期 ， 深 入 研究 亿 书 所 提供 的 交易 类 型 及 代码 实现 ， 集 中 总 结交 易 的 实现 过 程 ， 


这 是 “转账 交易 ”类 型 ， 注 册 用 户 名 、 签 名 等 交易 类 型 与 其 相似 


0 
a list (filter, cb) 
m getByld: (d, cb) 
m addUnconfirmedTransaction: (transaction sender, cb) 
© getUnconfirmedTransaction: (d) 
@ addDoubleSpending: (transaction) 
® pushHiddenTransaction: (transaction) 
® shiftHiddenTransaction: 0 
© deleteHiddenTransaction: 0 ©® verify: (trs, sender, cb) 
© getUnconfirmedTransactionList: (reverse) library.logic.transaction.attachAssetType | © Process: (trs, sender, cb) 
© removeUnconfirmedTransaction: (id) © getBytes: (trs) 
® processUnconfirmedTransaction: (transaction, broadcast cb) © apply: (trs, block, sender, cb) 
® applyUnconfirmedList: (ds, cb 9 
® undoUnconfirmedList: (cb) 
@ apply (transaction, block sender cb) ® undoUnconfirmed (trs sender cb) 
® undo: (transaction, block, sender cb) © objectNormalize: (trs) 
® applyUnconfirmed: (transaction, sender cb) © dbRead (raw) 
© undoUnconfirmed (transaction cb © dbSave: (trs cb) 
© receiveTransactions: (transactions cb) © ready (trs, sender) 
® sandboxApi: (call, args, cb) 


events- 


© onBind: (scope) 


© getTransactions: (req cb) 

@ getTransaction: (req cb) 

© getUnconfirmedTransaction: (req cb) 
@ getUnconfirmedTransactions: (req cb) 
© addTransactions: (req cb) 


O genesisblock scope.genesisblock block 


® create : (data) 

® attachAssetType : (typeld, instance) 

© sign ; (keypair, trs) 

@ multisign : (keypair, trs) 

© getld ; (trs) 

© getHash : (trs) 

© getBytes : (trs, skipSignature, skipSecondSignature) 


© verify : (trs sender, requester, cb) 
® verifysignature ; (trs publickey, signature) 
© verifySecondSignature : (trs, publicKey, signature) 


® undo : (trs block sender cb) 

日 applyUnconfirmed : (trs sender requester, cb) 
© undoUnconfirmed : (trs sender cb) 

© dbSave : (trs cb) 

© objectNormalize : (trs) 

® dbRead : (raw) 
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图 15-1 交易 类 图 及 其 关联 关系 


15.2 解读 


15.2.1 ”交易 的 本 质 


从 经 济 学 的 角度 来 说 ， 交 易 就 是 一 种 价值 交换 。 在 《精通 比特 币 》 ( 见 15.4 节 ) 一 书 里 ， 作 者 是 这 样 定义 比特 币 交易 的 : 简单 地 说 ， 交 易 是 指 把 比特 币 从 一 个 地 址 转 到 另 一 个 地 址 。 更 准确 地 说 ， 一 
笔 “ 交 易 ”就 是 一 个 经 过 签名 运算 的 ， 表 达 价 值 转移 的 数据 结构 。 每 一 笔 “ 交 易 ” 都 要 经 过 比特 币 网 络 传输 ， 由 矿工 节点 收集 并 封包 至 区 块 中 ， 永 久保 存在 区 块 链 的 某 处 。 


交易 ， 在 汉语 词典 里 ， 既 可 以 是 名 词 ， 代 表 交 易 内 容 的 数据 信息 (技术 上 称 为 数据 结构 ) ， 又 可 以 是 动词 ， 代 表 一 个 操作 过 程 。 把 这 些 重要 信息 汇总 到 一 起 ， 既 要 能 让 用 户 容易 理解 ， 又 要 体现 加 密 货 
币 的 特点 ， 那 么 可 以 这 样 定义 一 个 交易 操作 : 


加 密 货币 交易 是 指 人 们 通过 加 密 货币 网 络 ， 把 加 密 货币 进行 有 效 地 转移 ， 并 把 交易 数据 保存 到 区 块 链 的 过 程 。 


这 个 定义 与 我 们 的 直观 感受 比较 接近 。 通 常 ， 大 家 喜欢 把 加 密 货 币 交易 比 作 纸 质 支票 ， 支 票 本 身 就 是 记录 一 笔 交易 的 数据 结构 ， 从 签署 支票 到 兑付 完成 的 过 程 就 是 一 个 交易 操作 行为 。 一 笔 加 密 货币 交 
易 就 是 一 个 有 着 货币 转移 目的 的 电子 支票 ， 交 易 只 有 在 被 执行 时 才 会 在 金融 体系 中 体现 ， 而 且 交易 的 发 起 人 并 不 一 定 是 签署 该 笔 交 易 的 人 。 


交易 可 以 被 任何 人 在 线 上 或 线 下 创建 ， 即 便 创 建 这 笔 交易 的 人 不 是 这 个 账户 的 授权 签字 人 。 这 一 点 非常 好 理解 ， 假 如 有 一 张 空 的 纸 质 支票 ， 我 们 可 以 自己 填写 ， 也 可 以 找 人 填写 ， 最 后 只 要 有 支付 权限 
的 领导 签名 ， 支 票 就 能 生效 ， 就 可 以 兑付 。 加 密 货 币 也 是 如 此 ， 无 论 是 谁 创 建 的 加 密 货币 交易 ， 只 要 有 资金 所 有 者 ( 们 ) 的 数字 签名 ， 交 易 就 能 实现 。 


交易 只 是 一 些 经 过 加 密 处 理 的 字 节 码 ， 不 含 任何 机 密 信息 、 私 钥 或 密码 ， 可 以 被 包括 Wi-Fi、 无 线 电 在 内 的 任何 网 络 公开 传播 ， 甚 至 可 以 被 处 理 成 二 维 码 、 表 情 符 号 、 短 信 等 的 形式 进行 发 送 。 只 要 这 笔 
交易 能 够 进入 加 密 货币 网 络 ， 那 么 发 送 者 并 不 需要 信任 用 来 传播 该 笔 交 易 的 任何 一 个 网 络 节点 。 同 时 ， 这 些 节 点 也 不 需要 信任 发 送 者 ， 不 用 记录 发 送 者 的 任何 身份 信息 。 相 反 ， 电 子 商务 网 站 的 交易 ， 不 仅 
包含 敏感 信息 ， 而 且 还 会 依赖 加 密 网 络 连 接 完成 信息 的 传输 。 


因此 ， 从 本 质 上 讲 ， 加 密 货币 的 交易 是 价值 所 有 权 的 变更 ， 价 值 转移 仅仅 是 这 种 行为 的 结果 。 加 密 货币 的 总 量 一 直 就 是 那么 多 ， 从 始 至 终 都 不 会 发 生变 化 ， 人 为 丢失 的 只 是 人 类 流通 使 用 的 私 钥 权 限 ， 
那 部 分 加 密 货币 仍 在 网 络 上 不 会 丢失 ， 因 此 总 量 不 会 减少 。 记 录 加 密 货币 总 量 的 区 块 链 就 那 一 条 ， 这 个 链条 可 以 越 来 越 长 ， 越 来 越 大 ， 但 是 增加 的 仅仅 是 交易 信息 ， 即 价值 所 有 权 的 变更 信息 。 下 面 用 个 不 
太 确切 的 比喻 来 说 明 一 下 ， 加 密 货币 就 像 一 列 永 不 停息 的 火车 ， 上 下 的 是 人 次 ， 固 定 的 是 座位 ， 你 只 有 在 自己 的 人 生 旅 途中 才 拥有 某 个 座位 的 所 有 权 (使 用 权 ) 。 


从 设计 原理 上 来 说 ， 加 密 货币 淡化 了 交易 者 账号 ， 将 其 简化 为 输入 输出 ， 所 谓 的 账户 也 只 是 存在 于 客户 端 钱包 这 类 具体 的 应 用 层 的 软件 里 ， 就 像 那 列 火车 一 样 总 要 有 火车 站 的 吧 ， 而 某 一 段 旅程 的 火车 
票 是 有 具体 所 属 的 ， 是 要 与 现实 中 人 的 账号 或 身份 对 应 的 ， 所 以 火车 站 是 要 记录 用 户 信息 的 ， 要 有 检票 和 验 票 的 过 程 。 


亿 书 的 原理 也 是 如 此 ， 只 不 过 亿 书 通过 进一步 扩展 交易 类 型 ， 强 化 了 用 户 账号 的 存在 ， 使 其 更 加 适合 于 处 理 各 类 资产 所 有 权 ， 从 而 为 数字 版 权 保护 黄 定 了 良好 的 架构 基础 。 


15.2.2 ”交易 的 生命 周期 


区 块 链 产品 都 是 为 了 确保 能 够 正确 地 生成 交易 、 快 速 地 传播 和 验证 交易 ， 并 最 终 写 入 全 球 交 易 总 账簿 一 一 区 块 链 而 设计 。 


因此 ， 从 开发 设计 的 角度 来 考虑 ， 一 笔 交 易 必须 包括 如 下 的 过 程 。 


1) 生成 一 笔 交易 。 指 生成 一 条 包含 交易 双方 加 密 货 币 地 址 、 数 量 、 时 间 戳 和 有 效 签 名 等 信息 ， 而 且 不 含 任何 私密 信息 的 合法 交易 数据 。 


2) 广播 到 网 络 。 几 乎 每 个 节点 都 会 获得 这 笔 交 易 数据 。 


3) 验证 交易 的 合法 性 。 生 成 交易 的 节点 和 其 他 节点 都 需要 进行 验证 ， 没 有 得 到 验证 的 交易 ， 是 不 能 进入 P2P 网 络 的 。 


4) 写 入 区 块 链 。 


下 面 就 来 详细 阅读 和 分 析 亿 书 的 交易 是 如 何 实现 的 。 


目前 ， 亿 书 已 经 完成 或 正在 开发 的 交易 类 型 共有 14 种 (后 续 会 有 更 多 ) ， 具 体 如 下 : 


// helpers/transaction-types.js 
module.exports = { 
SEND : 0, 
SIGNATURE : 1, 
DELEGATE : 2, 
VOTE : 3， 
USERNAME : 4, 
FOLLOW : 5， 
MULTI: 6, 
DAPP: 7， 
IN TRANSFER: 8, 
OUT TRANSFER: 9, 
ARTICALE : 10, 
EBOOK: 11， 
BUY: 12, 
READ: 13 


重 签名 账号 、DAPP 是 侧 链 应 


其 中 ，SEND 是 最 基本 的 转账 交易 、SIGNATURE 是 第 14 章 提 到 的 签名 交易 、DELEGATE 是 注册 为 受托 人 、VOTE 是 投票 、USERNAME 是 注册 
、IN_TRANSFER 是 转 入 Dapp 资 金 、OUT_TRANSFER 是 转 出 Dapp 资 金 ， 这 些 是 现 有 版 本 已 经 完成 的 功能 。 


别名 地 址 、FOLLOW 是 添加 联系 人 、MULTI 是 注册 多 


ARTICALE 是 发 布 文章 、EBOOK 是 发 布 电子 书 、BUY 是 购买 电子 书 或 其 他 商品 ) 、READ 是 付费 阅读 (电子 书 等 ) ， 这 些 功能 会 逐步 添加 。 


这 些 交 易 ， 除 了 SEND 所 表示 的 转账 交易 之 外 ， 其 他 的 交易 类 型 ， 暂 且 称 之 为 功能 性 交易 (在 比特 币 的 圈子 里 ， 有 人 称 它们 为 伪 交 易 ) 。 


15.2.4 ”交易 的 基本 流程 


亿 书 交易 的 类 型 尽管 多 种 多 样 ， 但 是 交易 的 基本 逻辑 是 一 样 的 。 整 个 加 密 货币 都 是 交易 逻辑 的 有 效 组 成 部 分 ， 要 比 传统 的 电子 商务 网 站 复杂 得 多 ， 但 与 交易 直接 相关 的 代码 却 又 非常 简单 清晰 。 从 开发 


的 角度 来 阅 ， 实 现 一 笔 交易 ， 亿 书 需要 完成 这 样 几 个 步骤 。 


1. 生 成 交易 数据 


交易 是 人 类 的 行为 ， 将 会 涉及 甲乙 双方 (货币 的 发 送 者 和 接收 者 ， 分 别 用 日 


方 和 乙方 来 代替 ， 下 文 均 是 如 此 ) 和 交易 数额 ， 这 在 很 多 交易 ， 特 别 是 版 权 交 易 方 面 尤 为 重要 。 上 


方 是 


动 发 起 交易 的 有 效 


户 ， 是 亿 书 币 的 支付 方 ， 是 交易 的 支付 来 源 。 乙 方 则 比较 灵活 ， 既 可 以 是 另 一 个 有 合法 地 址 的 


一 句 简 


“ 交易 类 型 。 代 码 里 指 的 是 type: TransactionTypes.SEND。 


“ 支付 账号 。 代 码 里 指 的 是 sender: account。 


。 代 码 里 指 的 是 amount: body.amount。 


这 些 数 据 有 的 需要 
钥 和 接受 地 址 ， 也 能 把 旋 
码 ， 以 及 接受 方 用 户 地 址 是 否 合法 等 ， 都 要 逐个 检验 。 


户 手动 输入 ， 比 如 


网 


详情 请 看 图 15-2 所 示 的 流程 图 。 


的 话 来 概括 ， 那 就 是 谁 与 谁 交易 了 多 少 钱 。 可 用 下 面 转账 交易 部 分 的 代码 来 举例 ， 


货币 发 送出 去 ， 那 么 这 个 系统 就 太 脆弱 了 。 具 体 的 校 验 过 程 较为 繁琐 ， 主 要 会 涉及 如 下 几 个 方面 : 发 起 交易 的 


户 ， 也 可 以 是 亿 书 系统 本 身 (功能 性 的 交易 ) ， 是 亿 书 币 的 接收 方 。 


请 看 modulestransactions,js 文 件 里 的 763 和 800 行 处 的 代码 ， 一 笔 交易 必须 包含 如 下 字段 。 


。 代 码 里 指 的 是 recipientId: recipientId。 如 果 用 的 是 别名 地 址 ， 那 就 是 recipientUsername: recipientUsername; 如 果 是 功能 性 交易 ， 那 么 这 里 就 不 需要 了 。 


密 铀 、 交 易 数量 等 ， 这 些 数据 是 否 正确 ， 也 是 非常 关键 的 事情 。 这 是 软件 程序 验证 逻辑 的 一 个 重要 部 分 ， 不 可 或 缺 。 这 个 很 好 理解 ， 如 果 一 个 人 胡乱 填写 密 


户 是 否 存 在 、 密 钥 是 否 正 确 、 是 否 多 重 签名 账号 、 是 否 有 支付 密 


代码 在 shared.addTransactions() 方 法 里 “ 


"基本 验证 : 确保 人 为 输入 的 信息 正确 。 ” 
必须 字段 : secret amount recipientld" 


put /apl/transactions/ 


llbrary .scheme.valldate() 


是 否 符 合 字段 要 求 


生成 公 钥 keypalir,publicKey 


验证 甲 方 ( 发 送 方 ) 用 户 合法 性 


削 在 机 单 页 面 ， 要 求 用 户 重 新 境 写 


多 重 屿 号 字段 包 蔬 甲 方 


调用 户 ? 
提供 ? 


| 


本 FT 应 该 首先 验证 NS 
em -i 


2. 给 合法 交易 签名 


3. 验 证 交易 合法 性 


4. 广 播 到 点 对 点 网 络 


全 


2 .为 合法 交易 签名 


图 15-2 ”生成 交易 数据 流程 图 


如 果 基 本 信息 全 部 正确 ， 那 么 要 想 进 行 一 笔 合 法 交易 ， 还 要 使 用 甲乙 双方 的 公 钥 签 名 ， 以 确保 交易 所 属 。 同 时 ， 还 
杂 ， 


富 的 加 密 信息 ， 而 且 生 成 过 程 也 极其 复 


网 


详情 请 看 图 15-3 所 示 的 流程 图 。 


3. 验 证 交易 合法 性 


通常 ， 一 笔 交易 经 过 6~10 个 区 块 的 确认 之 后 ， 这 笔 交 易 便 被 认为 是 无 法 更 改 的 ， 因 为 这 时 候 再 去 进行 拒绝 和 变更 的 难 


全 部 正确 之 外 ， 主 要 是 要 保证 交易 是 未 确认 的 交易 ， 且 不 是 用 户 重复 提交 的 交易 。 


每 笔 交易 在 广播 到 网 络 之 前 都 必须 验证 其 合法 性 ， 不 合法 的 交易 是 没有 机 会 广播 到 网 络 的 。 节 点 收 到 新 的 交易 信息 


由 此 得 到 大 大 提高 。 


绝 不 像 传统 的 网 站 系统 ， 让 数据 库 自动 生成 索引 就 可 以 充当 ID 了 。 


准确 记录 它 的 交易 时 间 戳 ， 以 便于 追溯 。 接 着 生成 交易 ID， 每 个 交易 ID 都 包含 了 丰 


度 已 经 非常 大 ， 理 论 上 已 经 是 不 可 能 的 村 


情 了 。 


这 上 


有 2 的 交易 合法 性 ， 除 了 基本 信息 


验证 合法 的 交易 就 可 以 直接 加 入 区 块 链 了 ， 因 此 从 上 面 的 第 一 步 到 现在 ， 亿 书 都 是 在 一 个 节点 上 完成 的 。 这 也 为 下 


处 理 过 程 就 会 重复 执行 一 次 。 


上 面 提 到 的 用 户 重复 提交 的 交易 ， 是 双 花 交易 的 一 种 方式 。 双 花 交 易 也 称 为 双 花 攻击 ， 是 指 一 笔 资金 的 双 
费 一 定 的 时 间 ) ， 又 一 次 提交 了 交易 信息 (可 能 是 改变 了 接收 方 或 支付 数额 ) ， 并 在 自己 算 力 支持 的 情况 下 ， 让 第 二 笔 交易 所 在 的 


次 。 历 史上 曾 发 生 过 比特 币 双 花 攻击 的 事件 。 


网 


关于 验证 的 具体 过 程 ， 请 看 图 15-4 所 示 的 流程 图 。 


4 广播 到 点 对 点 网 络 


面 的 广播 处 理 打 下 了 基础 ， 一 


花费， 是 加 密 货 f 


旦 交易 被 


6 特有 的 现象 ， 通 俗 地 说 ， 就 是 


需要 重新 验证 。 如 此 一 来 ， 对 网 络 的 任何 攻击 ， 都 只 会 影响 一 个 节点 ， 安 全 性 也 


播 到 了 网 络 ， 在 其 他 节点 上 ， 这 里 的 验证 和 


户 在 交易 确认 之 前 (确认 的 过 程 都 需要 花 
区 块 分 支 快 速 得 到 确认 ， 从 而 让 第 一 笔 交易 作废 ， 成 功 实现 一 笔 钱 花 两 


如 果 没 有 中 心服 务 器 ， 则 必须 借助 点 对 点 网 络 ， 把 交易 数据 写 入 分 布 式 公共 账本 一 一 区 块 链 ， 保 证 交易 数据 永远 无 法 篡改 ， 而 且 还 可 以 轻松 查询 、 追 溯 。 在 中 心 化 的 服务 器 上 ， 为 了 应 对 个 别 交易 摩 
擦 ， 保 证 交易 记录 可 追 洲 ， 还 需要 采取 更 多 的 技术 手段 ， 记 录 更 多 的 数据 字段 ， 这 也 意味 着 要 保持 大 量 数据 匈 余 ， 付 出 更 多 资金 成 本 。 


因为 交易 数据 不 含 私密 信息 ， 对 网 络 也 没有 苛刻 要 求 ， 因 此 加 密 货币 的 网 络 覆 盖 面 可 以 很 广 ， 对 


更 多 复杂 的 因素 。 当 然 ， 就 亿 书 这 款 产品 而 言 ， 其 独 有 的 用 户 协作 和 分 享 功 能 ， 对 网 络 编程 的 性 能 是 有 


络 的 编程 也 会 变 得 灵活 很 多 。 理 论 上 ， 只 要 能 够 保证 连通 的 便捷 和 快速 ， 在 具体 设计 中 就 不 需要 考虑 


其 自身 的 要 求 的 ， 


体 到 把 交易 信息 广播 到 网 络 ， 所 需要 的 网 络 功能 就 简单 得 多 ， 将 交易 广播 到 网 络 的 流程 具体 如 


15-5 所 示 。 


此 需要 另 当 别论 ， 这 方 


面 将 在 下 一 个 版 本 中 体现 出 来 。 


2. 给 合法 交易 签名 


代码 在 logic.transaction.create() 方 法 里 将 交易 信息 交 给 logic.transaction.create() 进 一 步 处 理 


这 里 的 时 间 蕉 不 是 直接 使 用 


Date.now() 获 得 ， 而 是 亿 书 
系统 统一 处 理 的 。 请 看 书 中 添加 时 间 芍 : timestamp: slots.getTime() 


实践 部 分 有 关 时 间 稚 的 文章 


甲 方 签名 : trs.signature = this.sign(data.keypair, trs) 


如 果 有 支付 密码 ， 甲 方 进行 二 次 签名 : trs.signSignature = this.sign(data.secondKeypairtrs); 


交易 ID 不 是 一 个 简单 的 随机 数 ， 
mr 
地 址 、 交 易 数额 等 直接 相关 的 Hash 值 


计算 交易 费用 ( fee ) 


4. 广 播 到 点 对 点 网 络 
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15-3 为 合法 交易 签名 的 流程 图 


| I | 


2 .给 合法 交易 签名 


3. 验 证 交易 合法 性 


代码 在 modules.transactions,receiveTransactions() 方 法 里 ， 
显然 ， 新 建 并 签名 的 交易 数据 属于 未 确认 交易 


library.logic.transaction.processftransactiom sender, requester,cb) library.logic.transaction.process(transaction, sender,cb) 


这 个 是 转账 交易 类 型 ， 该 函数 本 身 也 进行 了 系列 验证 ， 这 个 是 除 转 账 之 外 的 功能 性 交易 类 型 ， 
并 使 用 交易 ID 查询 区 块 链 数据 库 ， 确 保 交 易 属于 未 完成 如 注册 别名 地 址 等 


这 里 要 避免 " 双 花 "问题 “ private.doublespendingTransactions[transaction.ld] 


前 面 数据 整理 部 分 是 对 数据 正确 性 的 处 理 ， 
rr 
一 性 、 交 易 费 、 数 额 、 时 间 稚 等 ， 代 码 简 单 


. LS 
ht transactions.prototype.applyUnconfirmed() 


library.logic.transaction.applyUnconfirmed(transaction, Sender requester cb); 


通过 该 方法 把 交易 信息 关联 到 (加 入 ) 到 区 块 链 、 this.scope.account.merge(sender.address,) 
private.types[trs.type].applyUnconfirmed.call(this, trs sender,) 


4. 广 播 到 点 对 点 网 络 


© 
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图 15-4 ”验证 交易 合法 性 流程 图 


1. 生 成 交易 数据 


4. 广 播 到 点 对 点 网 络 


"触发 未 处 理 交易 事件 ， 广 播 到 网 络 ， 其 中 broadcast=true" 2. 给 合法 交易 签名 


library.bus.message('unconfirmedTransaction', transaction, broadcast); [ ,验证 交易 合法 性 


modules/transport.js，/ 


transport.onUnconfirmedTransaction() modules.peer.update() 


该 方法 发 出 广播 指令 ， SS | 当 该 节点 请 求 成 功 时 ， 
包含 广播 的 节点 数量 、 交易 结束 之 后 ， 就 会 . 
交易 数据 、 请 求 方法 趁机 更 新 该 节点 的 状态 


该 方法 获得 指定 数量 节点 ， 并 逐个 随机 执行 下 面 的 方法 、 


当 找 到 某 节点 ， 该 方法 就 把 交易 数据 ， 
通过 post 方 法 发 送 到 `api/peer/transactions “接口 ， 
整个 过 程 ， 是 使 用 request 组 件 模拟 浏览 器 实现 的 


request(req,[]) 
router.post("/transactions,function()}) 
library.balancesSequence.add() 
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图 15-5 ”将 交易 广播 到 点 对 点 网 络 流程 图 


15.2.5 ”转账 交易 分 析 


前 面 几 章 介绍 了 几 种 交易 类 型 ， 比 如 : 注册 别名 地 址 和 多 重 签名 地 址 ， 不 过 并 没有 研究 具体 的 交易 过 程 ， 下 面 将 通过 分 析 转 账 交易 来 学 习 整 个 交易 和 验证 的 过 程 。 


在 modules/transactions.js 文 件 里 有 有 具体 的 代码 实现 ， 主 要 API 如 下 : 


// 148 行 

router.map (shared, { 
"get /": "getTransactions", 
"get /get": "getTransaction", 
"get /unconfirmed/get": "getUnconfirmedTransaction", 
"get /unconfirmed": "getUnconfirmedTransactions", 
"put /": "addTransactions" 


D); 


// 160 行 
library.network.app.use('/api/transactions', router); 


解析 一 下 ， 就 是 : 


get /api/transactions/ -> shared.getTransactions 

get /api/transactions/get -> shared.getTransaction 

get /api/transactions/unconfirmed/get -> shared.getUnconfirmedTransaction 
get /api/transactions/unconfirmed -> shared.getUnconfirmedTransactions 
put /api/transactions/ -> shared.addTransactions 


这 里 仍然 略 过 读 取 数据 的 AP1, 


加 


为 它们 很 简单 ， 下 


回 


就 来 重点 掌握 写 数据 的 操作 ，put/api/transactions/， 对 应 方法 为 shared.addTransactions， 代 码 如 下 : 


// 652 行 
shared.addTransactions = function (req, cb) { 
Var body = req.body; 
library.scheme.validate (body, { 
type: "object", 
properties: { 
secret: { 
type: "string", 
minLength: 1, 
maxLength: 100 


"integer", 


maximum: constants.totalAmount 


$s 

recipientId: { 
type: "string", 
minLength: 1 


}, 

PublicKey: { 
type: "string", 
format: "publicKey" 

ti 

secondSecret: { 
type: "string", 
minLength: 1, 
maxLength: 100 

ky 

multisigAccountPublicKkey: { 
type: "string", 
format: "PublicKey" 


hy 
// 
required: ["secret", "amount", "recipientId"] 
}, function (err) { 
// 验证 数据 格式 
if (err) { 
return cb (err[0] .message); 


} 


// 验证 密码 信息 
Var hash = crypto.createHash ('sha256') .update (body.secret, 'utf8').digest (); 
Var keypair = ed.MakeKeypair (hash); 


if (body.publicKey) { 
if (keypair.publicKey.toString('hex') != body.publicKey) { 
return cb ("Invalid passphrase"); 
} 
} 


var query = {}; 


// 乙方 (接收 方 ) 地 址 转换 ， 保 证 可 以 进行 用 户 名 转账 
var isaddress = /^[0-9]+[L|1]$/g; 
if (isAddress.test (boqy.recipientId)) { 
query.address = body.recipientId; 
} else { 
query.username = body.recipientId; 


library.balancesSequence.add (function (cb) { 
// 验证 乙方 用 户 合法 性 
modules.accounts.getAccount (query, function (err, recipient) { 
if (err) { 
return cbl(err.toString()); 
} 
if (!recipient && query.username) { 
return cb ("Recipient not found"); 


} 


var recipientId = recipient ? recipient.address : body.recipientId; 
Var recipientUsername = recipient ? recipient.username : null; 


// 验证 甲 方 〈 发 送 方 ) 用户 合 法 性 
if (body.multisigAccountPublicKey && body.multisigAccountPublicKey != keypair.publicKey.toString('hex')) { 


// 验证 多 重 签 
modules.accounts.getAccount ({publicKey: body.multisigAccountPublicKey}, function (err, account) { 
if (err) { 
return cbl(err.toString()); 
} 
// 多 重 签名 账号 不 存在 
if (!account || !account.publicKey) { 


return cb ("Multisignature account not found"); 


} 
// 多 重 签名 账号 未 激活 
if (!account || !account.multisignatures) { 
return cb("Account does not have multisignatures enabled"); 


} 

// 账号 不 属于 该 多 重 签名 组 

if (account.multisignatures.indexOf (keypair.publicKey.toString('hex')) < 0) { 
return cb ("Rccount does not belong to multisignature group"); 


} 


// 接着 验证 甲 方 ( 发 送 方 ) 用 户 合法 性 
modules.accounts.getAccount ({publicKey: keypair.publicKey}, function (err, requester) { 
if (err) { 
return cbl(err.toString()); 


} ; 

// 甲 方 账号 不 存在 

if (!requester || !requester.PublicKey) { 
return cbl("Invalid requester"); 


} 


// 甲 方 支付 密码 〈 二 次 签名 ) 不 正确 
if (requester.secondSignature && !body.secondSecret) { 
return cb ("Invalid second passphrase"); 


} 


// 甲 方 账号 公 钥 与 多 重 签名 账号 公 钥 是 不 一 样 的 (因为 两 个 账户 是 不 一 样 的 》 
if (requester.publicKey == account.publicKey) { 
return cb ("Invalid requester"); 


} 


Var secondKeypair = null; 


if (requester.secondSignature) { 
Var secondHash = crypto.createHash('sha256'). 


update (body. secondSecret, 'utf8') .digest(); 


secondKeypair 


} 


try { 


ed.MakeKeypair (secondHash); 


// 763 行 处 的 代码 把 上 述 数 据 整 理 成 所 需要 的 交易 数据 结构 ， 
// 并 给 交易 添加 时 间 戳 、 签 名 、 生 成 TD、 计算 交易 费用 等 


Var transaction 


type: TransactionTypes.SEND, 
amount: body.amount, 


sender: account, 


recipientId: recipientId, 
recipientUsername: recipientUsername, 


keypair: keypair, 


requester: keypair, 
secondKeypair: secondKeypair 


1); 


} catch (e) { 


return cbl(e.toString()); 


} 
// 776 行 ， 处 理 交 易 


library.logic.transaction.create ({ 


modules .transactions.receiveTransactions ( [transaction]， 


ch)s 
Ds 
D); 


} Sloe { 


// 直接 验证 甲 方 (发 送 方 ) 用 户 合法 性 ， 这 里 的 请 求 者 requester 就 是 发 出 交易 者 sender 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


上 面 这 段 代 码 所 涉及 的 就 是 生成 交易 数据 ， 这 与 第 13 章 和 第 14 章 里 提 到 的 功能 性 交易 差不多 ， 这 里 只 是 把 该 方法 的 代码 完整 地 粘贴 出 来 ， 


接 下 来 ，776 行 处 的 代码 ， 通 过 receiveTransactions 方 法 处 理 交易 ， 该 方法 最 终 调 


的 是 下 面 的 方法 。 关 键 部 分 已 经 添加 了 注释 ， 请 结合 上 


体 逻 辑 请 看 代码 里 的 注释 和 前 


的 流程 


网 


四 


的 流程 


[出 


在 


进行 阅读 ， 后 文 不 再 详 述 : 


// modules/transactions.js 文 件 
// 337 行 
Transactions.prototype.processUnconfirmedTransaction 
modules.accounts.setAccountAndGet 
// 这 是 一 个 闭 包 ， 在 下 面 的 程序 运行 
// 因此 是 验证 完毕 才 写 入 区 块 链 并 广播 到 网 络 的 
function done (err) { 
if (err) { 
return cb (err); 


} 
// 这 里 加 入 区 块 链 操作 


function 


(transaction, broadcast, cb) { 


privated.addUnconfirmedTransaction (transaction, sender, function (err) { 


if (err) { 
return cb (err); 


} 
// 触发 事件 ， 广 播 到 网 络 


library.bus.message ('unconfirmedTransaction', transaction, broadcast); 


cb (); 
i) 
} 
if (err) { 
return done (err); 


} 


({publicKey: transaction.senderPublicKey}, function (err, sender) { 


了 结束 的 时 候 才 会 调用 ， 


if (transaction.requesterPublicKey && sender && sender.multisignatures && sender.multisignatures.length) { 
modules.accounts.getAccount ({publicKey: transaction.requesterPublicKkey}, function (err, requester) { 


if (err) { 
return done (err); 


i 


if (!requester) { 
return cb ("Invalid requester"); 


} 
// 开始 执行 一 系列 的 验证 ， 包 括 交易 是 不 是 已 经 存在 


library.logic.transaction.process (transaction, sender, requester, function (err, transaction) { 


if (err) { 
return done (err):; 


} 
// 检查 交易 是 否 已 经 存在 包括 双 花 交易 


if (privated.unconfirmedTransactionsIdIndex[transaction.id] 


3 


return cb ("Transaction already exists"); 


} 
// 这 里 是 直接 验证 交易 签名 等 信息 ， 接 着 调用 闭 包 done ()， 


// 把 交易 写 入 区 块 链 并 广播 到 网 络 


!== undefined 


library.logic.transaction.verify (transaction, sender, done); 


D); 
]); 
} else { 


11 privated.doubleSpendingTransactions [transaction.id]) 
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15.3 总结 


本 章 的 编码 逻辑 非常 清晰 ， 但 作为 非常 核心 的 部 分 ， 本 章 使 


要 熟练 地 掌握 回调 处 理 方法 ， 不 然 理解 和 编码 都 会 有 很 多 困扰 。 


出 


本 章 所 涉及 的 流程 图 相对 比较 复杂 ， 为 了 方便 印刷 ， 本 章 把 完整 的 流程 
关于 交易 是 怎么 写 入 区 块 链 的 ， 本 章 仅仅 点 到 为 止 ， 不 够 详细 和 深入 。 为 了 进一步 阐述 


究 ， 相 关内 容 参 见 第 16 章 。 


15.4 参考 


Mon 


要 。 


了 大 量 的 编程 技巧 ， 需 要 比较 熟练 的 开发 技能 。 代 码 中 涉及 了 大 量 的 回调 和 验证 ， 有 的 回调 嵌 套 很 深 ， 需 要 对 异步 有 较为 深入 的 理解 ， 
因此 ， 好 好 熟悉 基本 的 编码 技巧 ， 从 小 处 着 手打 好 基础 很 


拆 分 成 了 4 张 ， 处 理 过 程 花费 了 大 量 时 间 ， 但 是 很 多 细节 仍然 无 法 顾及 ， 希 望 发 现 问题 的 读者 能 够 及 时 反馈 给 我 。 


区 块 链 的 原理 ， 需 


专门 拿 出 一 章 来 详细 讲述 。 而 且 ， 作 为 目前 互联 网 领域 的 热点 ， 


区 块 链 也 值得 我 们 好 好 有 


下 
而 


精通 比特 币 (英文 ) : https://github.com/imfly/bitcoinbook 


第 16 章 ”区 块 链 


亿 书 是 一 款 加 密 货币 产品 ， 用 当下 流行 的 话 来 说 ， 它 更 是 一 款 实用 的 区 块 链 产 品 。 那 么 ， 区 块 链 是 什么 ? 有 哪些 特点 ?2016 年 7 月 底 发 生 的 以 太 坊 硬 分 叉 事件 给 了 我 们 很 多 启示 ， 能 不 能 彻底 杜绝 区 块 


链 分 叉 行为 ?本 章 将 通过 认真 阅读 和 理解 亿 书 相关 的 代码 逻辑 ， 来 详细 解释 和 说 明 这 些 问题 ， 以 便 更 加 深入 地 了 解 和 学 习 这 项 技术 。 


16.1 源码 、 类 图 与 流程 图 


1. 源 码 


本 章 所 涉及 的 主要 源码 地 址 具体 如 下 。 
blocks.js: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/modules/blocks.js 
block.js: https://github.com/Ebookcoin/ebookcoin/blob/logic/block.js 


loaderjs: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/modules/loader.js 


由 
网 


区 块 链 相 关 类 图 及 其 关联 关系 如 图 16-1 所 示 。 


区 块 链 同步 与 创建 流程 图 如 图 16-2 所 示 。 


16.2 解读 


16.2.1 ”区 块 链 是 什么 


这 里 所 说 的 区 块 链 是 指 狭义 的 区 块 链 ， 是 一 种 自 引 用 的 数据 结构 ， 可 以 存储 成 文件 形式 ， 不 过 大 多 数 产品 都 存储 在 一 个 数据 库 中 ， 比 如 比特 币 使 
析 ， 请 看 第 一 部 分 的 第 4 章 ， 以 帮助 更 好 地 理解 区 块 链 概 念 。 


Google 的 LevelDB 数 据 库 进行 存储 。 详 细 的 概念 


<<require>> \<<require>> \<<require>> <<require>> 


OD modules: 0 
D library: 0 
口 lastBlock 
口 blockSstatus 
口 blocksDataFields 
D loaded 
口 isActive 
Private methods 
D library 罩 SaveGenesisBlock (cb) 
D loaded @ deleteBlock: (blockid, cb) 
0 I i a list: (filter, cb) 
口 oadingLastB oc| a getByld: (id cb) 
ER 四 saveBlock: (block cb) 
D total a popLastBlock (oldLastBlock cb) 
D blocksToSync a getIdSequence: (height, cb) 
D syndntervalld 目 readDbRows: (rows) a a 
@ applyTransaction: (block transaction, sender, cb pnivate me 
tta et hors by es a , 口 blockStatus 
中 人 © getCommonBlock (peer, height cb) 0 ey 
@ loadFullDb(peer, cb) ® count: (cb) HbRead(rows[i])) public methods 
m findUpdate(lastBlock, peer, cb) © loadBlocksData: (filter, options, cb) 日 create(datah block 
ml loadBlockstlastBlock cb) © loadBlocksPart: (filter, cb) © sign(block, keypair hash( hex') 
目 loadsignatures(cb) © loadBlocksOffset: (limit, offset, verify cb) © getBytes(block)}: bufferData 
@ loadUnconfirmedTransactions(cb) ® loadLastBlock: (cb) © verifysignature(block): boolean 
@ |oadBlockChain0 © getLastBlock © dbsave(block, 人 ct void 
© processBlock (block broadcast cb) © objectNormalize(block): block 
© simpleDeleteAfterBlock: (blocktd cb) © getId(block): bignumId 
© loadBlocksFromPeer: (peer, lastCommonBlockld, cb) © getHash(block): hash 
© deleteBlocksBefore: (block, cb) © calculateFee(block)}: 10000000 
© generateBlock: (keypair, timestamp, cb) © dbRead(raw): block 
: ee © sandboxApi: (call, args, cb) 
DOr @ onReceiveBlock (block) 
® onBind: (scope) 
© ei © cleanup: (cb) 
日 req < 


© getBlock (req, cb) 


© getBlocks: (req, cb) 

© getHeight: (req, cb) 

© getFee: (req cb) 

© getMilestone: (req, cb) 
© getReward: (req cb) 

日 getSupply: (req, cb) 

© getStatus: (req, cb) 

Cn 


© dbSequence [人 dblite 
二 一 一 一 一 
一 一 一 
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主要 用 来 处 理 区 块 链 同步 的 模块 


图 16-1 区 块 链 相关 类 图 及 其 关联 关系 


中 .保存 创 世 区 块 \ 


logic/block.js: dbSave() 


2. 加 载 本 地 区 块 


app.js: scope.bus.message("bind", scope.modules); 


3. 验 证 本 地 区 块 


block.previousBlock 上 private.lastBlock,id 
其 他 bind 事 件 modules/loader.js : Loader.prototype.onBind() llbrary,logic.block.verifySignature(block) 


modules/loader.js : private.loadBlockChain modules/delegates.js : validateBlockSIot 
logic/account.js : createTables() library.logic.transaction.verify(transaction,) 


modules/blocksjs : loadBlocksOffset() 
library,bus.message('blockchainReady"); 


library.bus.message('peerReady') 


modules/delegates.js : getBlockslotData() 


modules/loader.js : onPeerReady() 


modules/blocks.s : generateBlock() private.loadBlocks(lastBlock, cb); 


lastBlock.id == private,genesisBlock. 电 ock.id7? 


modules/transactions.js : BetUnconfirmedTransactionList() 


logic/block,js; create() private,findUpdate(lastBlock,(]) 


private.loadFullDb(data.peer,[]) 


modules/blocksjs : processBlock() modules.blocks.getCommonBlock() 


5. 产 生 区 块 链 分 叉 


W 


modules.delegates.fork() 4 种 原因 导致 分 叉 ， 请 看 文字 解释 S modules.transactions.undoUnconfirmedList() 


modules.round,directionSwap('backward',) 


令 
| 


如 果 没 有 分 叉 行为 ， 就 可 以 保存 和 广播 区 块 了 
seventoct re A 


modules blocks deleteBlocksReforef commonBlock) 


modules.blocks.loadBlocksFromPeer(peer,) 
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16-2 ”区 块 链 同步 与 创建 流程 图 


1. 从 数据 库 设计 的 角度 理解 区 块 链 


数据 库 的 概念 来 理解 ， 区 块 链 就 是 一 张 “ 自 引用 ”的 数据 库 表 。 每 条 记录 代表 着 一 个 区 块 ， 这 条 记录 (区 块 ) 记录 着 它 前 面 (时 间 上 ) 一 条 记录 的 信息 ， 可 以 直接 查询 到 前 一 条 记录 ， 因 此 可 以 从 任 
何 一 条 记录 开始 往 前 顺序 追 洲 ， 直 到 第 一 条 记录 。 普 通 自 引用 表 结构 通常 使 用 ID 作 为 关联 外 键 ， 加 密 货币 使 用 的 是 经 过 加 密 处 理 的 信息 字段 ， 具 有 签名 认证 的 作用 ， 可 实现 自我 验证 ， 以 防止 被 算 改 。 


与 区 块 链 直 接 关 联 的 另 一 张 重要 的 表 ， 就 是 交易 表 。 加 密 货币 包含 大 量 的 交易 ， 我 们 之 前 也 分 析 过 ， 交 易 可 以 是 加 密 货币 ， 也 可 以 是 债权 、 股 权 或 版 权 等 各 类 数字 资产 ， 这 些 交 易 保存 在 一 张 独立 的 表 
中 ， 并 且 与 区 块 链 形成 多 对 一 的 关联 方式 。 如 此 以 来 ， 只 要 追溯 到 区 块 ， 很 容易 就 能 查询 到 该 区 块 所 包含 的 交易 记录 了 。 这样， 一 个 公开 透明 、 无 法 纂 改 、 方 便 追 溯 的 账本 就 形成 了 。 


上 面 是 从 数据 库 查 询 (读数 据 ) 的 角度 来 考虑 的 ， 如 果 是 从 写 入 的 角度 来 思考 ， 那 就 更 有 意思 了 。 写 入 是 根据 不 同 的 需求 进行 不 同 的 编码 ， 前 面 的 章节 中 提 到 过 ， 加 密 货币 的 各 种 功能 都 可 以 通过 扩展 
交易 类 型 进行 编码 ， 如 果 把 现实 中 的 一 些 合同 规则 进行 编码 ， 要 求 系统 在 某 个 条 件 下 自动 执行 ( 写 入 或 更 新 ) 某 个 交易 ， 自 然 也 是 一 件 简 单 轻松 的 事情 ， 这 就 是 对 “智能 合约 ”的 简单 理解 。 


2.4 节 曾 提 到 过 “智能 合约 ”的 概念 ， 这 里 再 次 提 及 ， 作 为 程序 员 能 够 更 加 直观 地 去 理解 编码 上 的 可 行 性 。“ 智 能 合约 ”也 是 目前 区 块 链 技 术 社区 讨论 非常 火热 的 概念 ， 可 以 发 挥 你 的 想象 ， 从 加 密 货 
扩展 到 现实 世界 中 的 各 种 场景 都 可 以 引入 “智能 合约 ”， 比 如 : 自动 贩卖 机 、 销 售 终端 、 大 公司 间 的 电子 数据 交换 、 银 行 间 用 于 转移 与 清算 的 支付 网 络 ， 以 及 音乐 、 电 影 和 电子 书 等 数字 版 权 交易 等 。 


2 形象 化 理解 区 块 链 


人 们 通常 使 用 栈 来 表示 具有 先后 顺序 的 数据 结构 ， 比 特 币 白皮书 将 这 种 结构 进一步 形象 化 ， 第 一 个 区 块 作为 栈 底 ， 然 后 其 他 区 块 按照 时 间 顺 序 依次 堆 亚 在 上 面 ， 这 样 一 来 ， 栈 底 区 块 与 首 区 块 之 间 的 距 
离 表示 “高 度 ”，“ 顶 端 ” 表 示 最 新 添加 的 区 块 。 每 个 区 块 都 包含 了 大 量 交易 ， 也 就 是 包含 在 对 应 栈 里 的 数据 。 可 以 将 这 样 的 结构 想象 成 一 个 大 大 的 橱柜 ， 一 个 区 块 就 是 其 中 的 一 个 抽 导 ， 每 个 抽 居 里 都 是 
满 满 的 交易 ， 如 图 16-3 所 示 。 


3. 区 块 链 分 又 


1) 物理 分 又 。 每 一 个 区 块 都 与 它 的 前 一 个 区 块 ( 父 区 块 ) 相关 联 ， 而 对 它 后 面 的 区 块 ( 子 区 块 ) 则 无 限制 ， 也 就 是 说 最 顶端 的 区 块 ， 肯 定 知道 它 的 父 区 块 (已 经 写 入 区 块 链 ) ， 但 不 知道 它 的 子 区 块 
(或 许 还 没有 产生 ， 也 可 能 还 在 传输 的 过 程 中 ) 。 我 们 知道 ， 从 物理 层面 来 说 ,数据库 、 硬 盘 、 网 络 的 |/O 操 作 是 最 耗费 时 间 的 ， 在 某 一 个 时 刻 ， 多 个 最 新 区 块 同时 找到 父 区 块 是 很 常见 的 现象 ， 这 就 必然 会 
导致 区 块 链 分 又 (从 主 链 向 多 个 方向 发 展 ) 。 这 是 在 同一 个 软件 版 本 (及 其 兼容 版 本 ) 的 情况 下 发 生 的 ， 没 有 人 为 干预 ， 不 妨 称 之 为 物理 分 又 。 


图 16-3 ”区 块 链 形象 化 图 示 


显然 ， 物 理 分 叉 取决 于 物理 环境 ， 这 与 什么 样 的 共识 机 制 没有 直接 关系 ， 不 论 是 采取 工作 量 证 明 机 制 (PoW) 的 比特 币 、 还 是 采取 股权 证 明 机 制 (PoS) 的 点 点 币 ， 亦 或 是 这 里 采取 授权 股权 证 明 机 制 
(DPoS) 的 亿 书 币 ， 都 是 如 此 。 为 了 保持 区 块 链 的 单一 链条 ， 解 决 分 叉 的 最 简单 方式 就 是 放任 每 个 分 又 继续 增长 ， 通 常 在 下 一 刻 就 会 出 现 差别 ， 这 时 候 软 件 选 择 最 长 的 那个 链条 作为 主 链 即 可 。 在 具体 的 设 


计 开 发 过 程 中 ， 这 也 是 一 个 逻辑 相对 复杂 的 难点 。 


2) 人 为 分 又。 那么， 如 果 存 在 人 为 的 干预 ， 又 会 怎么 样 呢 ? 要 知道 ， 世 界 上 没有 绝对 完美 的 东西 ， 人 类 开发 设计 的 软件 也 不 例外 ， 漏 洞 是 常 有 的 ， 看 看 微软 的 Windows 系 统 时 不 时 跳出 来 的 漏洞 修复 
提醒 ， 就 知道 这 类 事情 多 么 常见 。 而 且 ， 人 类 的 需求 始终 都 在 变化 ， 软 件 也 要 不 断 推出 新 功能 来 应 对 需求 的 变化 。 所 以 ， 软 件 出 现 漏洞 ， 或 者 添加 新 的 功能 ， 这 类 情况 是 再 正常 不 过 的 事情 了 。 这 时 候 ， 卓 
版 本 的 软件 对 新 版 本 软件 产生 的 区 块 可 能 会 出 现 兼容 性 问题 ， 甚 至 需要 人 为 改变 区 块 链 的 走向 ， 这 就 必然 会 导致 新 旧版 本 之 间 出 现 分 又 ， 不 妨 称 之 为 人 为 分 叉 。 


很 显然 ， 人 为 分 叉 也 是 无 法 避免 的 事情 。 你 可 能 认为 这 很 简单 ， 有 漏洞 就 修复 ， 有 新 功能 就 如上， 没什么 好 解释 的 。 但 是 事实 上 ， 加 密 货 


6 的 核心 是 交易 ， 是 价值 转移 的 手段 ， 规 则 的 改变 直接 关系 到 


所 有 持 币 人 的 利益 。 新 功能 能 否 保护 用 户 的 利益 ， 还 是 只 代表 了 少 部 分 利益 集团 的 意志 ， 应 该 如 何 约束 和 决策 ， 这 已 经 不 仅仅 是 一 个 技术 问题 ， 更 多 的 是 社区 政治 问题 ， 需 要 社区 共同 参与 。 历 史 证 明 ， 承 
载 了 较 大 资金 盘 的 加 密 货币 ， 在 某 一 次 分 叉 过 程 中 ， 个 别 用 户 或 “矿工 ”没有 及 时 更 新 软件 ， 最 终 造成 了 直接 的 经 济 损失 。 所 以 ， 每 一 个 持 币 用 户 都 非常 关心 任何 一 次 分 叉 行为 ， 都 有 可 能 站 出 来 表达 自己 


的 意愿 ， 甚 至 选择 留 在 旧 链 上 。 因 此 ， 保 持 软件 兼容 ， 尽 量 避 免 人 为 分 叉 是 很 有 必要 的 。 


3) 硬 分 又 和 软 分 叉 。 它 们 都 属于 人 为 分 又， 识 优 熟 劣 也 是 当前 社区 中 分 层 比 较 严重 的 问题 。 最 初 ， 社 
的 、 规 则 明确 的 分 叉 行为 ，“ 软 分 又” 则 恰恰 相反 。 不 过 ， 发 展 到 今天 ， 只 要 是 明确 的 “分 又 ”行为 ， 大 家 都 会 寻求 社 
括 软件 开发 者 、 矿 工 和 使 用 者 在 内 的 整个 软件 社区 ， 采 取 投票 等 方式 ， 获 得 最 大 程度 的 一 致 性 意见 ， 通 常 是 如 果 有 90% 以 上 的 社 


Dao 遭 受 黑客 攻击 而 实施 的 紧急 硬 分 又 ， 就 获得 了 社区 87% 的 同意 (接近 90%， 本 书 不 讨论 这 次 分 叉 行为 的 好 坏 ) 。 


区 区 分 这 两 个 概念 的 简单 方法 就 是 ，“ 硬 分 又 ”与 旧版 本 的 兼容 度 不 高 ， 但 它 是 获得 了 社区 共识 
区 共识 ， 所 以 二 者 的 区 别 主 要 集中 在 软件 兼容 的 问题 上 了 。 这 里 的 社区 共识 ， 是 指 包 
区 成 员 同意 就 认为 是 达成 了 社区 共识 。 比 如 2016 年 7 月 底 以 太 坊 为 了 应 对 The 


从 技术 的 角度 来 讲 ， 这 里 所 谓 的 “ 硬 ”， 主 要 体现 在 与 | 旧版 本 的 不 兼容 (或 少量 兼容 ) 上 ， 属 于 抛弃 旧版 本 的 行为 ， 如 果 用 户 不 升级 软件 ， 就 会 永远 留 在 旧 链 上 ， 感 觉 上 要 强硬 得 多 。 “ 软 分 又 ” 则 最 
大 程度 地 保持 了 对 以 前 版 本 的 兼容 性 ， 做 得 好 的 话 ， 多 个 版 本 可 以 同时 运行 ， 类 似 于 正常 的 版 本 迁 代 升级 ， 用 户 可 以 自由 选择 是 否 升级 。 有 人 说 “ 硬 分 又 ”是 很 糟糕 的 事情 ， 另 一 些 人 则 认为 “ 软 分 又 ” 的 
风险 更 大 。 事 实证 明 ， 只 要 准备 充分 ， 操 作 得 当 ， 无 论 是 “ 硬 分 又 ”还 是 “ 软 分 又 ”， 都 不 可 怕 ， 只 不 过 “ 软 分 又 ”在 编码 中 需要 考虑 的 情况 更 加 复杂 ， 对 用 户 的 影响 较为 隐蔽 。 


加 密 货币 作为 交易 媒介 的 新 兴 产 物 的 持续 发 展 往往 是 不 同 利益 团体 (包括 开发 者 、“ 矿 工 。 和 用 户 ) 之 间 不 断 博弈 的 结果 。 最 初 是 开发 者 主导 ， 某 个 时 期 “矿工 ”的 力量 更 加 强大 ， 再 到 后 期 用 户 的 力 


量 就 会 不 容 忽 视 。 也 正 是 这 些 力量 之 间 的 制衡 ， 才 让 加 密 货币 能 够 相对 持续 稳健 地 发 展 ， 这 三 种 力量 达到 均衡 时 ， 就 是 这 个 加 密 货 


客 攻 击 事件 撑 动 了 整个 区 块 链 社 区 ， 不 同 利益 者 发 出 了 不 同 的 声音 ， 这 是 好 事 ， 充 分 说 明 区 块 链 技术 仍 处 在 初级 阶段 ， 还 有 很 长 的 路 要 走 。 


16.2.2 ”区 块 链 的 特点 


可 以 按照 堆栈 的 方式 理解 数据 结构 ， 并 采用 自 引 用 的 关联 方式 设计 数据 库 模 型 ， 但 是 即使 做 到 这 些 ， 笔 者 个 人 认为 这 样 并 不 代表 就 是 


由 P2P 网 络 节点 共同 维护 ， 才 能 称 得 上 是 区 块 链 。 当 然 ， 也 有 人 持 不 同 的 观点 ， 他 们 认为 一 个 中 心 化 的 应 月 


用， 如 果 使 用 


类 似 的 数据 结构 ， 


区 块 链 了 ， 


6 相对 成 熟 的 时 候 。2016 年 7 月 底 ， 以 太 坊 硬 分 叉 处 理 The Dao 遭 受 的 黑 


它 还 必须 使 用 加 密 解 密 技术 ， 被 置 于 去 中 心 化 的 网 络 ， 


( 比 不 使 有 


该 结构 的 中 心 化 系统 ) 会 更 加 安全 ， 同 时 还 可 以 避免 分 


又 ， 性 能 或 许 会 ( 比 去 中 心 化 的 系统 ) 更 高 ， 但 事实 是 ， 如 果 没 有 了 P2P 网 络 的 支撑 ， 那 么 这 点 改进 算 不 上 什么 。 之 前 分 析 过 ，P2P 网 络 本 身 就 是 一 条 非常 好 的 安全 屏障 ， 单 点 被 攻击 或 被 破解 ， 对 整个 网 络 
系统 没有 太 大 的 伤害 ， 而 任何 中 心 化 的 系统 仅仅 相当 于 单 节 点 ， 安 全 性 大 大 降低 。 所 以 ， 为 了 些许 的 性 能 改进 ， 却 要 牺牲 更 好 的 安全 性 ， 就 有 点 得 不 偿 失 了 。 


汇总 以 上 信息 ， 区 块 链 应 该 具备 如 下 几 个 特点 。 


:分布 式 存储 : 区 块 链 处 于 P2P 网 络 之 中 ， 无 论 是 公 链 、 私 链 还 是 联盟 链 ， 都 要 采取 分 布 式 存储 ， 使 用 一 种 机 制 保证 区 块 链 的 同步 和 统一 。 
“ 公开 透明 : 每 个 节点 都 要 有 一 个 区 块 链 副 本 ， 区 块 链 本 身 没有 加 密 ， 数 据 可 以 任意 检索 和 查询 ， 甚 至 可 以 修改 (因为 改 了 也 没 用 ， 对 其 他 节点 和 整个 网 络 没有 任何 影响 ) 。 


“ 无 法 自 改 : 这 是 加 密 技术 的 巧妙 应 用 ， 每 一 个 区 块 都 会 记录 前 一 个 区 块 的 信息 ， 并 实现 验证 ， 以 确保 无 法 壬 改 。 这 里 的 无 法 纂 改 不 是 不 能 改 ， 而 是 局 部 修改 的 数据 无 法 通过 验证 ， 著 想 要 通过 验证 ， 
必须 修改 整个 区 块 链 ， 这 在 理论 上 可 行 ， 操 作 上 不 可 行 。 


“ 方便 追溯 : 区 块 链 是 公开 的 ， 可 以 从 任 一 区 块 向 前 追溯 ， 直 到 第 一 个 区 块 ， 并 通过 区 块 查 到 与 之 关联 的 全 部 交易 。 


当然 ， 笔 者 认为 还 有 另 一 个 特点 ， 那 就 是 存在 分 又 ， 这 是 由 P2P 网 络 等 物理 环境 ， 以 及 软件 开发 实践 过 程 决定 的 ， 无 法 根本 性 杜绝 。 不 过 ， 有 人 说 ， 改 用 PBFT 共 识 算法 就 会 解决 分 又 问题 ， 实 际 上 ， 本 
质 上 并 没有 改变 ， 只 是 将 解决 分 叉 的 操作 提前 了 而 已 。 另 外 ， 对 于 因 软件 重大 升级 而 导致 的 分 叉 仍 然 无 法 避免 。 


也 正 是 因为 上 述 这 样 的 特点 ， 区 块 链 的 概念 才 逐 渐 火 爆 起 来 。 实 践 证 明 ， 区 块 链 技术 不 仅 能 实现 一 切中 心 化 应 用 的 场景 ， 而 且 可 以 解决 (或 更 好 地 解决 ) 很 多 中 心 化 应 用 无 法 解决 的 问题 ， 比 如 分 布 式 
财务 管理 、 分 布 式 存储 、 知 识 产权 保护 、 电 子 商务 乃至 物 联网 ， 特 别 是 对 于 金融 业 而 言 ， 资 金 清算 、 审 计 等 的 成 本 会 大 幅度 降低 。 亿 书 就 是 利用 它 公 开 透 明 、 可 追溯 的 特点 ， 与 数字 出 版 结合 起 来 ， 实 现 自 
媒体 和 版 权 保护 ， 彻 底 解决 当前 数字 出 版 版 权 保护 不 力 的 顽疾 。 


16.2.3 ”区 块 链 开发 应 该 解决 的 问题 


明白 区 块 链 是 什么 和 其 基本 原理 之 后 ， 就 可 以 着 手 设计 其 基本 功能 了 。 从 需求 的 角度 来 说 ， 设 计 中 需要 做 到 如 下 几 点 。 


1) 加 载 区 块 链 。 确 保本 地 区 块 链 是 合法 的 ， 未 被 自 改 。 


“ 保存 创 世 区 块 。 
“加载 本 地 区 块 。 
“ 验证 本 地 区 块 。 


2) 处 理 新 区 块 。 加 载 后 ， 该 节点 就 可 以 处 理 网 络 中 的 交易 了 。 


“ 创建 新 区 块 。 


“ 收集 整理 交易 ， 写 入 (关联 ) 区 块 。 


“ 把 新 产生 的 区 块 写 入 区 块 链 。 


3) 同步 区 块 链 。 确 保本 地 区 块 链 与 网 络 中 完整 的 区 块 链 同步 。 


下 面 就 从 数据 库 的 设计 开始 ， 分 别 研读 相关 代码 ， 深 入 讨论 亿 书 区 块 链 是 如 何 运作 的 。 


16.2.4” 亿 书 区 块 链 数 据 库 设计 


亿 书 使 用 SQLite 数 据 库 ， 与 区 块 链 相关 的 数据 库 结构 如 图 16-4 所 示 。 


blocks 表 代表 区 块 链 ，trs 表 代表 各 种 交易 ，forks_stat 表 代表 分 叉 状 态 。 从 关联 关系 上 看 ，blocks 首 先是 一 个 自 引用 表 ， 使 用 previousBlock 关 联 ; 与 trs 是 一 对 多 的 关系 ， 一 条 记录 关联 着 多 条 交易 ; 与 
forks_stat 也 是 一 对 多 的 关系 ， 意 思 是 有 分 又。 


© id: VARCHAR PRIMARY KEY 

id: VARCHAR PRIMARY KEY © blockld: VARCHAR FOREIGN KEY 
version: INT © type: TINYINT 
timestamp: INT © timestamp: INT 
height: INT O senderPublicKey: BINARY 
previousBlock: VARCHAR FOREIGN KEY x | © Senderld: VARCHAR 
numberOfTransactions: INT ietHsE © recipientId: VARCHAR 
totalAmount: BIGINT © senderUsername: VARCHAR 
totalFee: BIGINT © recipientUsername: VARCHAR 
reward: BIGINT © amount: BIGINT 
payloadLength: INT © fee: BIGINT 
payloadHash: BINARY © signature: BINARY 
generatorPublicKey: BINARY © signSignature: BINARY 
© blockSignature: BINARY © requesterPublicKey: BINARY 

© signatures: TEXT 


O0000000000pD0 


O delegatePublicKey: BINARY 
© blockTimestamp: INT 

© blockld: VARCHAR 

© blockHeight: INT 

© previousBlock: VARCHAR 

© cause: INT 


copyright (€) imfly 2016.07.18 http://bitcoin-on-nodejs.ebookchain.org 


图 16-4” 亿 书 区 块 链 数 据 库 表格 关联 图 


16.2.5” 亿 书 区 块 链 的 实现 


本 节 将 按照 上 面 提 到 的 开发 区 块 链 要 解决 的 问题 ， 逐 一 对 照 来 查看 亿 书 技术 的 实现 。 


1. 保 存 创 世 区 块 


创 世 区 块 是 硬 编码 到 客户 端 程序 里 的 ， 会 在 客户 端 运行 的 时 候 直接 写 入 数据 库 。 这 样 做 的 好 处 是 保证 每 一 个 客户 端 都 有 一 个 安全 、 可 信 的 区 块 链 的 根 。 保 存 创 世 区 块 的 代码 如 下 : 


// modules/blocks.js 

// 78 行 

function Blocks (cb，scope) { 
library = scope; 
// 80 行 
genesisblock = library.genesisblock:; 
self = this; 
self. private = privated; 
privated.attachApi (); 


// 85 行 
privated.saveGenesisBlock (function (err) { 
setImmediate (ch, err, self); 


D); 


这 是 modules/blocks,js 模 块 的 构造 函数 ， 在 入 口 程 序 app.js 运 行 的 时 候 ， 直 接 创建 该 模块 的 实例 ， 运 行 第 85 行 处 的 privated.saveGenesisBlock 方 法 。 如 果 已 经 运行 过 ， 那 么 该 方法 就 会 返回 ， 什 么 都 
不 做 。 如 果 是 第 一 次 运行 ， 那 么 该 方法 就 会 直接 保存 创 世 区 块 (80 行 处 的 genesisblock) ， 接 着 调用 266 行 处 的 privated.saveBlock () 方法 (不 再 粘贴 ) ， 把 创 世 区 块 记录 (包括 交易 ) 保存 到 数据 库 中 。 


这 是 一 个 非常 典型 的 区 块 创建 过 程 ， 我 们 可 以 借 此 机 会 看 看 一 个 〈 创 世 ) 区 块 的 数据 是 什么 样 的 : 


// genesisBlock.json 文件 
{ 
"version": 0, 


好 


"totalAmount": 10000000000000000, 

"totalFee": 0, 

"reward": 0, 

"payloadHash": "lcedb278bd64b910c2d4b91339bc3747960b9e0acf4a7cda8ec217c558f429ad", 
"timestamp": 0, 

"numberOfTransactions": 103, 

"payloadLength": 20326, 

"previousBlock": null, 

"generatorPublicKey": "b7b46c08c24d0f91df5387f84b068ec67b8bfff8f7f4762631894fce4aff6c75", 


AX/ 1757 行 
"height": 1, 
"blockSignature": 


"2985d896becdb91c283cc2366c4a387a257b7d4751f995a81leae3aa705bc24fdb950c3afbed833e7d37a0a18074da461d68d74a3a223bc5f8e9clfed2f3fec0e", 
"id": "8593810399212843182"， 


// 12 行 ， 为 了 阅读 方便 ， 这 里 把 关联 的 交易 信息 排版 到 了 最 后 面 的 位 置 
"transactions": [ 

{ 

"type": 0, 


/7 1 
"amount": 10000000000000000, 
"fee": 0, 
"timestamp": 0, 
"recipientId": "6722322622037743544L", 
"senderId": "5231662701023218905L", 
"senderPublicKey": "b7b46c08c24dq0f91dqf5387f84b068ec67b8bfff8f7f4762631894fce4aff6c75"， 
"signature": 
"aad13208c32400589895049ff21797048fa41c1b2ffc866900ffd97570f8487e852c87074ed77c6b914f47449ba3f9d6dca99874d9f235ee4c1c83d1d81b6e07"， 
"id": "5534571359943011068" 
}, 
{ 
"type": 2, 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
ks 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


{ 
"type": 3, 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


bE 


上 面 的 数据 库 表 里 已 经 列 出 过 这 些 字段 ， 下 面 就 来 看 看 几 个 关键 的 数据 。 


第 3 行 : 在 创 世 区 块 设 定 初始 代 币 总 量 ， 这 里 是 1 亿 ; 第 1757 行 : 创 世 区 块 高 度 为 1; 第 12 行 : 区 块 必须 包含 交易 ， 这 里 是 3 种 类 型 的 交易 ， 之 前 分 析 过 ， 它 们 分 别 是 转账 交易 、 受 托 人 交易 和 投票 交易 。 


第 1 个 转账 交易 是 把 初始 区 块 的 代 币 全 部 转 到 另 一 个 账户 ， 这 在 实际 的 生产 环境 中 ， 特 别 是 在 ICO ( 预 售 ) 之 后 ， 可 以 直接 转 给 参与 众 筹 的 实际 用 户 。 所 以 ， 创 世 区 块 有 其 非常 实际 的 意义 。 其 他 两 种 交易 是 


于 支撑 亿 书 共识 机 制 的 。 


2. 加 载 本 地 区 块 


任何 节点 都 需要 先 加载 验 证 本 地 区 块 链 ， 确 保 其 没有 被 自 改 。 这 个 加 载 过程 是 软件 初始 化 过 程 中 的 一 部 分 ， 开 发 中 不 需要 将 其 与 网 络 节点 连 网 等 其 他 问题 纠缠 在 一 起 。 因 此 ， 代 码 需 要 被 放 在 入 口 文件 


中 去 执行 。 在 第 10 章 里 对 appjjs 文 件 进行 了 解读 ， 但 是 并 不 详细 ， 仅 仅 梳理 了 程序 的 大 致 流程 。 这 里 重新 提 及 ， 重 点 专注 于 区 块 链 加 载 验证 的 问题 ， 这 在 具体 开发 过 程 中 是 很 正常 的 增 量 开发 的 思路 。 加 载 
本 地 区 块 的 代码 如 下 : 


// app.js 文 件 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
ready: ['modules', 'bus', function (cb, scope) { 
// 435 行 
scope.bus.message ("bind", scope.modules); 
cb (); 
所 


appjs 文 件 435 行 处 的 代码 表示 触发 了 “bind” 事 件 ， 会 执行 所 有 模块 里 的 “onBind () ”方法 。 该 方法 在 运行 之 前 ， 各 个 模块 只 是 被 实例 化 ， 处 于 待命 状态 ， 所 以 “bind” 事 件 是 激活 各 模块 的 


件 ， 是 继 各 模块 构造 函数 运行 之 后 的 关键 方法 。 大 部 分 模块 里 的 “onBind () ”方法 仅仅 用 于 初始 化 某 个 变量 ， 唯 独 loader.js 模 块 执行 了 下 面 的 代码 : 


// modules/loader.js 文 件 

Loader .prototype.onBind = function (scope) { 
modules = scope; 
// 534 行 
Privated.loadB1ockChain (); 

}; 


modules/loader.js 文 件 534 行 处 的 代码 : privated.loadBlockChain () 方法 就 是 用 来 加 载 区 块 链 的 ， 内 容 如 下 : 


// modules/loader.js 文 件 
privated.loadBlockChain = function () { 

Var offset = 0, limit = library.config.loading.loadPerIteration; 
Var verify = library.config.loading.verifyOnLoading; 


// 357 行 ， 闭 包 

function load(count) { 
verify = true; 
Privated.total = count; 


library.logic.account.removeTables (function (err) { 
if (err) { 
throw err:; 


} else { 
library.logic.account.createTables (function (err) { 
if (err) { 
throw err:; 
} else { 
// 369 行 
async.until( 
function () { 


return count < offset; 
ys function (cb) 1 
library.logger.info('Current ' + offset); 
setImmediate (function () { 
modules.blocks.loadBlocksOffset (limit, offset, verify, function (err, lastBlockOffset) { 
i (err)y 1 
return cb (err); 


} 

// 380 行 

offset = offset + limit; 
privated.loadingLastBlock = lastBlockOffset; 


cb (); 
]); 
])3 
}, function (err) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
// 398 行 
library.logger.info('Blockchain ready'); 


library.bus.message ('blockchainReady'); 
} 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
} 


// 408 行 
library.logic.account.createTables (function (err) { 
if (err) { 
throw err:; 
} else { 
library.dbLite.query("select count (*) from mem accounts where blockId = (select id from blocks where numberOfTransactions > 0 order by height desc limit 1)", {'cour 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
Var reject = ! (rows[0] .count); 


modules.blocks.count (function (err, count) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


if (reject || verify || count == 1) { 
// 428 行 
load (count); 

} else { 


// 其 他 情况 ， 请 查看 源码 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


408 行 处 的 代码 : 将 调用 logic/accountjjs 文 件 的 createTables () 方法 ， 创 建 与 用 户 相关 的 账号 信息 表 ， 全 部 以 “mem_” 开 头 ， 主 要 包 
括 “mem_accounts”“mem_accounts2contacts”“mem_accounts2u_contacts” “mem accounts2delegates” “mem accounts2u delegates” 
8 个 表 。 这 些 信息 只 与 用 户 相关 ， 不 需要 被 其 他 节点 同步 。 


“mem _accounts2multisignatures” “mem a 


如 果 是 新 客户 端 ， 数 据 库 为 初始 创建 ， 创 世 区 块 为 第 一 次 写 入 ， 那 么 count==1， 会 立刻 调用 闭 包 load () 函数 (428 行 处 ) ， 加 载 验证 缺失 的 区 块 。 这 里 先 不 考虑 其 他 情况 ， 直 接 查 看 357 行 处 的 
load () 函数 ， 可 以 发 现 该 函数 先 删 除了 账号 表格 (removeTables) ， 然 后 重建 表格 (createTables) ， 并 通过 “async.until” 方法 (369 行 处 ) 进行 循环 加 载 区 块 链 数 据 ， 具 体 方法 是 
modules/blocks.js 的 loadBlocksOffset () 。 当 count<offset 返 回 “true” 的 时 候 ， 循 环 结束 ， 区 块 链 数据 同步 完毕 ， 然 后 触发 “blockchainReady” 事 件 (398 行 处 ) 。 


这 里 的 “Offset” 不 是 分 页 数据 ， 而 是 一 次 加 载 的 区 块 数量 ， 这 样 做 的 好 处 是 避免 一 次 性 加 载 全 部 区 块 链 ， 否 则 会 导致 数据 请 求 量 过 大 ， 影 响 计算 机 性 能 。 这 个 值 最 大 是 limit 的 值 (380 行 处 ) ，limit 
等 于 “configjson” 文 件 设 定 的 全 局 变量 loading.loadPerlteration。 用 户 可 以 修改 该 配置 文件 ， 在 启动 软件 时 通过 命令 行 参数 “-c” 选 择 自己 的 配置 文件 ， 从 而 实现 定制 ， 代 码 如 下 : 


// config.json 文 件 

// 132 行 

"loading": { 
"verifyOnLoading": false, 
"loadPerIteration": 5000 


3. 验 证 本 地 区 块 


上 文 提 到 过 modules/blocks.js 的 loadBlocksOffset () 方法 才 是 处 理 加 载 的 具体 方 


， 也 是 验证 的 方法 所 在 ， 其 代码 如 下 : 


// modules/blocks .js 文件 
Blocks .prototype.loadBlocksOffset = function (limit, offset, verify, cb) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
library.dbSequence.add (function (cb) { 
library.dbLite.query ("SELECT " + 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
async.eachSeries (blocks, function (block, cb) { 
async.series([ 
function (cb) { 
if (block.id != genesisblock.block.id) { 
if (verify) { 
// 627 行 ， 追 溯 区 块 
if (block.previousBlock != privated.lastBlock.id) { 
return cb ({ 
message: "Can't verify previous block", 
block: block 
js 
} 


try { 
// 635 行 ， 验 证 块 签名 
Var Valid = 
library.logic.block.verifySignature (block); 
} 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
if (!valid) { i 
return cb ({ 
message: "Can't verify signature", 
block: block 
])3 


} 
// 650 行 ， 验 证 块 时 段 Slot 
modules .delegates.validateBlockSlot (block, function (err) { 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
jr function (toeb} 1 


// 先 对 交易 排序 ， 让 投票 或 签名 交易 排 在 前 面 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
async.eachSeries (block.transactions, function (transaction,cb) { 
if (verify) { 
modules.accounts.setAccountAndGet ({publicKey: tran- 
saction.senderPublicKey}, function (err, sender) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
if (verify && block.id != genesisblock.block.id) { 
// 690 行 ， 验 证 交易 
library.logic.transaction.verify (transaction, sender, function (err) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
]); 
} else { 
setImmediate (cb); 
} 
}, function (err) { 
if (err) { 
// 如 果 出 现 错误 ， 则 回 深 
async.eachSeries (transactions.reverse(), function 
(transaction, cb) { 
async.series([ 
function (cb) { 
modules.accounts.getAccount ({publicKey: transaction.senderPublicKey}, function (err, sender) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
modules .transactions.undo 
(transaction, block, sender, cb):; 


3)5 
}，function (cb) { 


modules .transactions.undoUnconfirmed 
(transaction, cb); 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
}s 


逐个 加 载 区 块 并 验证 ， 具 体 如 下 。 


: 627 行 处 的 代码 : 追溯 前 一 区 块 ， 若 无 法 追溯 ， 则 自然 是 不 正确 的 。 


“ 635 行 处 的 代码 : 验证 块 签名 ， 防 止 块 内 容 被 自 改 。 建 议 认 真 阅读 该 行 调用 的 签名 验证 方法 “verifySignature () ” (在 “logic/block.js” 文 件 的 第 150 行 处 ， 请 去 源码 库 查 看 ) ， 这 应 该 是 对 二 进 制 数据 
(这 里 是 区 块 数据 ) 进行 签名 验证 的 典型 用 法 。 如 果 验 证 失败 ， 就 要 终止 整个 循环 ， 删 除 该 块 及 其 以 后 的 块 。 


“ 650 行 处 的 代码 : 验证 块 时 段 Slot， 防 止 块 位 置 被 自 改 。 这 里 的 代码 实际 上 是 变相 验证 了 区 块 的 高 度 及 其 时 间 玲 (相关 技术 参见 第 四 部 分 25.1 节 中 的 讨论 ) 。 亿 书 网 络 按照 一 定 的 周期 循环 (具体 内 容 
参见 第 17 章 ) ， 每 一 个 块 都 可 以 根据 其 高 度 计算 出 它 的 出 块 时段 ， 这 与 它 的 时 间 玲 是 对 应 的 ， 这 就 锁定 了 区 块 位 置 ， 否 则 就 会 存在 问题 。 为 什么 要 选择 验证 块 时 段 ， 而 不 是 简单 直接 的 高 度 或 时 间 戳 ? 这 是 
因为 区 块 链 有 分 叉 的 情况 ， 相 同 高 度 存在 多 个 块 和 时 间 戳 ， 但 相同 的 块 时段 只 能 是 一 个 。 


:690 行 处 的 代码 : 验证 交易 。 具 体 流程 参见 第 15 章 的 相关 内 容 。 


4 .创建 新 区 块 


上 文 是 从 设计 的 角度 正 向 提供 的 一 种 实现 思路 。 下 文 将 反 向 阅读 代码 ， 不 再 思考 为 什么 ， 仅 仅 查 看 是 什么 ， 从 这 个 角度 体会 一 下 读 代 码 是 一 件 多 么 简单 的 事情 。 需 要 注意 的 是 ， 流 程 轿 
按照 模块 设计 的 基本 原则 ， 处 理 区 块 链 的 代码 ， 都 应 该 集中 在 “modules/blocks.js” 文 件 里 ， 所 以 ,我 们 很 容易 就 能 找到 创建 新 区 块 的 代码 “generateBlock () ”方法 ， 代 码 具体 如 下 : 


反 向 查看 。 


// modules/blocks .js 文件 

// 1126 行 

Blocks .prototype.generateBlock = function (keypair, timestamp, cb) { 
// 1127 行 ， 获 取 未 确认 的 交易 ， 并 再 次 验证 ， 放 入 一 个 数组 变量 里 备用 
Var transactions = modules.transactions .getUnconfirmedTransactionList (); 
var ready = []; 


async .eachSeries (transactions, function (transaction cb) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
ready.push (transaction); 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
J Function (y 
try { 
// 1147 行 
Var block = library.logic.block.create ({ 
keypair: keypair, 
timestamp: timestamp, 
previousBlock: privated.lastBlock, 
transactions: ready 
])3 
} catch (e) { 
return setImmediate (cb, e); 


} 


// 1157 行 
self.processBlock (block, true, cb); 


该 方法 很 简单 。1127 行 处 的 代码 : 获取 未 确认 的 交易 ， 并 再 次 验证 ， 放 入 一 个 数组 变量 “ready” 里 备用 。 从 这 里 的 处 理 方法 可 以 得 知 ， 与 亿 书 区 块 关联 的 交易 并 没有 实现 比特 币 那 样 复杂 的 处 理 方 
法 。 比 特 币 区 块 链 中 的 所 有 交易 ， 均 以 二 叉 树 (Merkle) 的 形式 表示 ， 对 于 存储 、 维 护 、 查 询 、 验 证 交易 都 有 很 多 便利 。 亿 书目 前 的 代码 没有 这 样 的 优势 ， 这 点 将 在 以 后 的 版 本 中 优化 添加 。 


1147 行 处 的 代码 : 把 整理 好 的 数据 组 合成 块 数据 结构 (具体 形式 类 似 于 前 面 的 创 世 区 块 ) ， 因 为 是 新 建 数据 ， 重 要 的 是 keypair、timestamp、previousBlock 和 transactions 4 个 字段 信息 。 其 他 字 
段 , 诸如 totalFee、reward、payloadHash 等 ， 将 会 在 执行 “processBlock () ” (1157 行 ) 时 进行 处 理 。 


这 里 的 keypair、timestamp 字 段 是 该 方法 的 参数 ， 需 要 在 调用 的 地 方 传 入 。 通 过 查询 代码 可 以 发 现 ， 仅 在 “modules/delegates.js” 文 件 里 调用 了 该 方法 ， 其 方法 是 “loop” ， 很 显然 该 方法 就 是 产生 
区 块 的 入 口 方法 ， 代 码 如 下 : 


// modules/delegates .js 
// 492 行 
Privated.loop = function (cb) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
Var currentSslot = slots.getSlotNumber (); 
Var lastBlock = modules.blocks.getLastBlock (); 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
Oty 
privated.getBlockSlotData (currentSlot, lastBlock.height + 1, function (err, currentBlockData) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
library.sequence.add (function (cb) { 
if (slots.getSlotNumber (currentBlockData.time) == slots.getSlotNumber()) { 
// 519 行 
modules .blocks .generateBlock (currentBlockData.keypair, currentBlockData. 
time, function (err) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


http: / /wom .hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


如 果 去 掉 一 些 必要 的 判断 ， 那 么 在 真正 调用 的 时 候 其 实 还 是 非常 简单 的 。 看 看 上 面 的 “loop” 方 法 ,真正 与 “modules/delegates.js” 模 块 关联 的 调用 是 “privated.getBlockSlotData () ”方法 
(470 行 处 的 代码 ) ， 该 方法 从 名 字 上 理解 就 是 获得 块 时 段 数据 ， 为 区 块 提供 密 铀 对 和 时 间 戳 。 由 于 是 私有 方法 ， 因 此 可 以 猜想 该 方法 一 定 与 受托 人 有 关 ， 下 面 让 我 们 了 解 一 下 : 


// modules/delegates .js 
// 470 行 
privated.getBlockSlotData = function (slot, height, cb) { 
self.generateDelegateList (height, function (err, activeDelegates) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
for (; CcurrentSlot < lastSlot; currentSlot += 1) { 


var delegate pos = currentSlot % constants.delegates; 
var delegate id = activeDelegates[delegate pos]; 


if (delegate id && privated.keypairs[delegate id]) { 
return cb (nul1，{time: slots.getSlotTime (currentSlot), keypair: privated.keypairs[delegate id]}); 


} 
} 
cb(null, null); 
1)s 


从 上 述 代码 可 以 看 出 ， 该 方法 首先 获得 可 以 生产 区 块 的 受托 人 列表 ， 然 后 根据 当前 时 段 信息 找到 激活 的 受托 人 标识 ， 继 而 找到 对 应 的 密 铀 对 ， 所 以 这 个 密 钥 对 是 与 特定 时 段 的 特定 受托 人 相关 的 。 


接 下 来 ， 要 运行 “privated.loop () ”方法 才 可 以 实现 新 建 区 块 的 操作 ， 所 以 继续 搜索 代码 ， 很 轻松 就 能 找到 该 代码 : 


// modules/delegates .js 
J/ 735 行 
Delegates .prototype.onBlockchainReady = function () { 
Privated. loaded = true; 
Privated. loadMyDelegates (function nextLoopl(err) { 
// 743 行 
Privated.loop (function () { 
setTimeout (nextLoop, 1000); 
}); 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


这 是 “onBlockchainReady” 事 件 方法 ， 上 面 分 析 了 ， 当 本 地 区 块 链 加 载 完毕 就 会 调用 该 方法 ， 也 就 是 说 ， 当 区 块 链 加 载 验证 完毕 就 可 以 创建 新 区 块 了 。 这 里 设 定 每 秒 钟 (744 行 处 设 定 了 1000 毫 秒 ) 
调用 一 次 “privated.loop() ”方法 ， 但 是 因为 Slot 的 限制 ， 实 际 运行 起 来 是 每 10 秒 钟 产生 一 个 块 。 


从 上 面 的 分 析 中 可 以 知道 ， 在 同步 缺失 区 块 操 作 之 前 ， 还 有 一 个 更 新 节点 信息 的 过 程 ， 这 样 一 来 ， 本 地 区 块 链 加载 完 毕 ， 创 建新 区 块 比 同步 缺失 的 区 块 要 时 一 些 。 这 点 可 以 在 最 大 程度 上 保证 节点 创建 
区 块 的 奖励 ， 并 让 节点 最 大 程度 地 服务 于 亿 书 网 络 ， 当 然 ， 这 样 做 也 增加 了 同步 区 块 操作 的 难度 。 


5. 产 生 区 块 链 分 又 


具体 到 编码 ， 区 块 链 什么 时 候 产生 分 叉 呢 ? 显然 应 该 在 新 区 块 写 入 区 块 链 的 时 候 ， 也 就 是 modules/blocks,js 文 件 执行 1157 行 处 的 “processBlock () ”方法 的 时 候 。 检 索 该 方法 的 调用 ， 会 发 现在 


1174 行 处 的 “onReceiveBlock () ”方法 里 ， 以 及 1084 行 处 的 “loadBlocksFrompPeer () ”方法 里 ， 都 调用 了 该 方法 ， 只 有 在 “loadBlocksFromPeer () ”方法 里 ，“processBlock () ”方法 不 执行 
广播 操作 。 


该 方法 很 长 ， 但 并 不 复杂 ， 下 面 仅 粘贴 与 分 义 相 关 的 源码 ， 具 体 如 下 : 


// modules/blocks.js 文 件 
// 800 行 
Blocks .prototype.processBlock = function (block, broadcast, cb) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
if (block.previousBlock != privated.lastBlock.id) { 
// 859 行 ， 高 度 相 同 ， 父 块 不 同 
modules.delegates.fork (block, 1); 
return done("Can't verify previous block: " + block.id)， 
l 
Ee 
if (err) { 
// 877 行 ， 受 托 人 时 段 不 同 
modules .delegates .fork (block, 3); 
return done("Can't verify slot: " + block.id); 


} 


if (tId) { 
// 910 行 ， 交 易 已 经 存在 
modules.delegates. fork (block, 2); 
setImmediate (cb， "Transaction already exists: " + transaction.id); 


上 面 列 出 了 3 种 ， 还 有 一 种 : 


// modules/blocks .js 文件 
// 1166 行 
Blocks .Prototype.onReceiveBlock = function (block) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
if (block.previousBlock == privated.1lastBlock.previousBlock && block.height = privated.lastBlock.height && block.id != privated.lastBlock.id) { 
// 1181 行 ， 高 度 和 父 块 相同 ， 但 块 ID 不 同 
modules .delegates .fork (block, 4); 
Cb("Eorkn)s 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


有 实 上 ， 这 里 写 入 分 又 的 “modules.delegates.fork () ”方法 ， 其 代码 很 简单 ， 仅 仅 是 向 “forks_stat” 表 插入 对 应 数据 而 已 。 需 要 重点 关注 的 是 ， 上 面 罗 列 了 4 种 分 又 ， 它 们 分 叉 的 原 


加 


体 如 下 。 


“859 行 处 的 代码 : 块 高 度 相 同 ， 父 块 不 


本 
本 


可 


。 可 能 是 父 块 验证 出 现 了 问题 。 
“910 行 处 的 代码 : 交易 已 经 存在 。 可 能 用 户 重复 提交 了 交易 ， 典 型 的 代表 就 是 “ 双 花 问题 ”。 
“ 877 行 处 的 代码 : 受托 人 时 段 不 同 。 出 现时 段 验 证 错误 ， 而 块 时 段 是 与 时 间 鹤 相关 的 ， 所 以 可 能 是 时 间 处 理 出 现 了 问题 。 


"1166 行 处 的 代码 : 高 度 和 父 块 都 相同 ， 但 块 ID 不 同 。 这 是 接收 来 的 块 ， 高 度 值 应 该 比 最 新 块 的 高 度 值 大 1， 才 会 正常 写 入 区 块 链 ， 不 然 就 只 能 写 入 分 又 。 块 的 ID 信息 是 对 块 进行 sha256 加 密 计 算得 出 的 
结果 ，ID 不 同 说 明 所 获得 的 可 能 是 不 同 分 支 上 的 块 。 


6. 同 步 区 块 链 ， 并 解决 分 叉 


上 文 提 到 过 ， 当 加 载 验证 本 地 区 块 结束 时 ， 程 序 触发 了 “blockchainReady” 事 件 (modules/loaderjs 398 行 处 ) ， 于 是 执行 了 各 个 模块 里 对 应 的 “onBlockchainReady () ”方法 。 如 果 查 看 每 个 
模块 对 应 的 “onBlockchainReady () ”方法 ， 就 能 很 轻松 地 了 解 接 下 来 程序 在 做 什么 。 


下 面 就 来 考察 如 何 从 其 他 节点 同步 区 块 链 ， 自 然 要 先 看 看 节点 模块 里 对 应 的 方法 。 第 11 章 中 已 经 给 出 了 “onBlockchainReady () ”方法 的 代码 ， 这 里 就 不 再 重复 了 。 请 看 对 应 源码 的 第 364 行 ， 该 行 
在 更 新 了 节点 之 后 ， 调 用 了 “library.bus.message ('peerReady') ”方法 ， 触 发 了 另 一 个 “peerReady” 事 件 。 这 才 是 我 们 最 想 要 的 ， 再 次 回 到 modules/loaderjs 文 件 ， 该 文件 也 定义 
了 “peerReady” 事 件 ， 代 码 如 下 : 


// modules/loader.js 

// 492 行 

Loader .prototype.onPeerReady = function () { 
setImmediate (function nextLoadBlock() { 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
// 499 行 
privated.1loadBlocks (lastBlock, cb); 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
]); 


setImmediate (function nextLoadUnconfirmedTransactions() { 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
// 514 行 


privated.1loadUnconfirmedTransactions (function (err) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


D); 


setImmediate (function nextLoadSignatures() { 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
// 523 行 


privated.1loadSignatures (function (err) { 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
]); 


该 事件 方法 通过 “privated.loadBlocks () ”等 三 个 方法 分 别 同步 区 块 (499 行 处 ) 、 未 确认 交易 和 签名 。 限 于 篇 幅 ， 这 里 仅 分 析 “privated.loadBlocks () ” 方法， 关于 其 他 两 个 逻辑 ， 请 自行 查阅 


// modules/loader.js 
// 225 行 
privated.loadBlocks = function (lastBlock, cb) { 


// 226 行 
modules.transport .getFromRandomPeer ({ 
api: '/height', 
method: "GET' 
}, function (err, data) { 
Var PeerStr = data && data.peer ? ip.fromLong (data.peer.ip) + ":" + data.peer.port : 'unknown'; 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
if (bignum(modules.blocks.getLastBlock() .height) .lt (data.body.height)) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
if (lastBlock.id != privated.genesisBlock.block.id) { 
// 259 行 
privated.findUpdate (lastBlock, data.peer, cb); 
} else { // Have to load full db 
// 261 行 
Privated.1loadFullDb (data.peer, cb); 
} 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
]); 


办 


226 行 处 的 “transport.getFromRandomPeer () ”方法 已 经 在 第 11 章 中 分 析 过 了 ， 这 里 不 再 歼 述 。 该 方法 通过 随机 选择 节点 ， 并 调用 这 里 提供 的 API 获 得 远程 节点 的 “height” 数 据 。 在 确保 本 地 
块 链 高 度 小 于 远程 节点 区 块 链 高 度 的 前 提 下 ， 如 果 本 地 是 创 世 区 块 ， 则 同步 远程 节点 的 整个 数据 库 , 调 用 “privated.loadFullDb () ” 方法， 否则 就 调用 “privated.findUpdate () ”方法 更 新 缺失 的 区 
块 。 前 者 很 简单 ， 属 于 后 者 的 特殊 情况 ， 因 此 仅 分 析 后 者 即 可 ， 代 码 如 下 : 


// modules/loader.js 
// 75 行 
privated.findUpdate = function (lastBlock, peer, cb) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/.. 
// 80 行 ， 获 得 正常 块 
modules .blocks .getCommonBlock (peer, lastBlock.height, function (err, commonBlock) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
Var toRemove = lastBlock.height - commonBlock.height; 


站 本 (toRemove > 1010) 
// 89 行 ， 该 节点 的 分 这 太 长， 要 限制 从 该 节点 同步 数据 〈1 小 时 ) 
1ibrary.1ogger.1og("1ong fork, ban 60 min", peerSstr); 
modules .peer. state (peer.ip, peer.port, 0, 3600); 
return cb(); 


} 
// 和 暂 存 未 确认 的 交易 


Var overTransactionList = []; 
modules.transactions.undoUnconfirmedList (function (err, unconfirmedList) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
async.series([ 
tunction (cb) 1 
if (commonBlock.id != lastBlock.id) { 
// 还 能 反 向 循环 
modules.round.directionSwap ('backward', lastBlock, cb); 
} else { 
cb (); 
] 
function (cb) 
// 娄 开 天地 和 能 
library.bus.message ('deleteBlocksBefore', commonBlock); 
// 117 行 ， 删 除 正常 块 之 前 的 块 
modules.blocks.deleteBlocksBefore (commonBlock, cb) ; 


] 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
function (cb) { 
// 129 行 
modules .blocks.1loadBlocksFromPeer (peer, commonBlock.id, function 
(err, lastValidBlock) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


这 个 方法 相对 比较 复杂 ，80 行 处 的 代码 ， 为 什么 是 获得 正常 块 (或 标准 块 ) 呢 ? 因为 上 面 有 4 种 分 叉 的 块 ， 都 被 保存 在 一 个 数据 库 表 “blocks” 里 ， 需 要 通过 查询 把 分 叉 的 (不 正常 的 ) 块 过 滤 掉 。89 
行 处 的 代码 ， 最 新 块 与 正常 块 之 间 的 高 度 差 太 大 ， 说 明 该 节点 的 分 支 太 长 ， 暂 时 限制 从 该 节点 同步 数据 ， 可 以 提高 效率 ， 也 能 减少 出 错 概率 。117 行 处 的 代码 ， 把 分 叉 的 块 删除 掉 ， 就 能 解决 分 叉 问题 。129 
行 处 的 代码 ， 这 里 与 创 世 块 的 处 理 方法 比较 相似 。 


里 需要 说 明 的 是 ， 真 实 的 数据 库存 储 的 数据 ， 绝 对 不 是 像 前 面 所 描述 的 那样 是 一 个 个 标准 的 抽 居 罗列 在 一 起 。 很 多 情况 下 ， 正 常 的 区 块 和 分 又 的 区 块 都 是 按照 时 间 的 顺序 被 存储 在 一 起 的 ， 是 杂乱 无 
的 ， 展 示 给 用 户 的 是 经 过 代码 过 滤 之 后 的 数据 。 而 我 们 定义 的 区 块 链 是 经 过 编码 实现 的 理想 结果 ， 这 点 应 该 不 难 理解 。 


16.3 总结 


VGN= 口 


本 章 从 技术 的 角度 描述 了 区 块 链 的 相关 概念 ， 并 结合 源码 ， 解 读 了 亿 书 区 块 链 的 相关 实现 ， 这 对 于 直观 了 解 和 学 习 区 块 链 是 很 有 帮助 的 。 特 别 是 在 社区 里 ， 有 些 币 圈 网 友 认为 压根 就 不 应 该 有 区 块 链 分 
， 本 章 的 回答 可 能 会 让 他 们 失望 了 。 在 现实 世界 里 ， 理 想 永 远 是 遥 不 可 及 的 事情 ， 只 有 更 好 ， 没 有 最 好 。 因 此 ， 包 括 区 块 链 技术 在 内 ， 只 要 是 介入 人 类 经 济 生态 的 应 用 ， 永 远 都 不 只 是 单纯 的 技术 性 问 
题 ， 更 深层 次 的 问题 在 于 社区 以 及 基于 人 类 经 济 生态 的 政治 文化 。 


本 章 没有 讨论 区 块 链 相 关 的 公共 AP1， 因 为 它们 都 是 数据 库 读 取 操 作 ， 难 度 不 大 ， 按 照 以 往 的 惯例 ， 都 是 留 给 读者 自己 去 阅读 。 整 体 来 说 ， 这 部 分 相对 复杂 ， 对 于 区 块 链 分 叉 的 处 理 ， 以 及 与 区 块 相关 联 


的 交易 ， 还 需要 更 多 的 优化 ， 我 们 会 在 后 续 的 版 本 中 继续 升级 改造 。 


聪明 的 小 伙伴 一 定 看 出 来 了 ， 对 于 创建 新 区 块 、 分 叉 等 都 是 受托 人 模块 (modules/delegatesjs) 的 核心 功能 ， 受 托 人 是 DPos 机 制 的 内 容 ， 所 以 要 想 更 深层 次 地 把 握 本 章 的 知识 ， 还 应 该 再 深入 一 步 ， 
切实 掌握 亿 书 的 共识 机 制 。 


16.4 参考 


《精通 加 密 货 币 》 作 者 Andreas 问 答 : http://8btc.com/thread-36622-1-1.html 


二 


区 块 链 》: http://www.8btc.com/what-is-blockchain 


《关于 比特 币 硬 分 又 和 软 分 叉 的 争议 》: http://www.8btc.com/on-consensus-and-forks 


二 


以 太 坊 软 分 叉 失败 ， 硬 分 叉 成 功 》: http://8btc.com/thread-36657-1-1.html 


第 17 章 ”DPoS 机 制 


共识 机 制 是 分 布 式 应 用 软件 所 特有 的 算法 机 制 。 在 中 心 化 的 软件 里 ， 再 复杂 的 问题 都 可 以 避 开 使 用 复杂 的 算法 逻辑 (当然 ， 如 果 能 用 算法 统领 ， 代 码 会 更 加 简洁 、 高 效 ) ， 在 开发 设计 上 可 以 省 却 一 定 
的 麻烦 。 但 在 分 布 式 软件 开发 中 ， 节 点 间 的 互 操作 ， 节 点 行为 的 统一 管理 ， 若 没有 算法 理论 作为 支撑 ， 则 将 根本 无 法 实现 。 所 以 ， 要 想 开发 基于 分 布 式 网 络 的 区 块 链 产 品 ， 共 识 机 制 将 是 无 法 回避 的 。 


本 书 的 第 一 部 分 第 3 章 已 经 详细 介绍 过 共识 机 制 的 作用 ， 也 对 比 了 当前 区 块 链 技术 常用 的 三 种 共识 算法 的 原理 和 优 缺 点 ， 但 是 并 没有 对 共识 算法 进行 深入 讨论 。 本 章 就 从 解释 “拜占庭 将 军 问题 ”开始 ， 
探讨 区 块 链 算法 问题 ， 并 通过 代码 来 学 习 和 研究 亿 书 共识 机 制 的 具体 实现 。 


17.1 源码 与 类 图 


1. 源 码 


本 章 所 涉及 的 主要 源码 地 址 具体 如 下 。 

delegates.js: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/modules/delegates.js 
round,js: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/modules/round.js 
accounts.js: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/modules/accounts.js 


slots.js: https://github.com/Ebookcoin/ebookcoin/blob/v0.1.3/helpers/slots.js 


2. 类 图 


DPoS 机 制 相关 类 


网 


及 其 关联 关系 如 图 17-1 所 示 。 


© milestones: 0 
© distance: 3000000 
© rewardOffset: 60480 


public methods 
© parseHeight: (height) 
© calcMilestone: (height) 
© calcReward: (height) 
© calcSupply (height) 


17.2 ”受托 人 数据 库 表 


党 


户 是 DPoS 机 制 的 一 部 分 ， 特 别 是 mem_round 表 。 与 受托 人 相关 的 数据 库 表 格 关联 关系 


国 attachApi 0 

@ getKeysSortByVote (cb) 

男 getBlockSlotData (slot, height, cb) 
男 loop (cb) 

四 l0adMyDelegates (cb) 


© generateDelegateList (height cb) 

© checkDelegates (publicKey, votes, cb) 

© checkUnconfirmedDelegates (publicKey, votes, cb) 
© fork (block cause) 

© validateBlockSslot (block cb) 

© sandboxApi (call, args, cb) 


onBind (scope) 
onBlockchainReady 0 
cleanup (cb) 


© getDelegate (req, cb) 
© getVoters (req, cb) 

© getDelegates (req, cb) 
© getFee (req, cb) 

© enableForging (req, cb) 
© disableForging (req, cb) 
© statusForging (req, cb) 
© addDelegate (req, cb) 


beginEpochTime() 
加 getEpochTime(time) 


© getTime (time) 

© getRealTime (epochTime) 
© getSlotNumber (epochTime) 
© getSlotTime (slot) 

© getNextSlot 0 

© getLastSlot (nextslob) 


口 loaded 
口 feesByRound 
口 rewardsByRound 
口 delegatesByRound 
口 UnFeesByRound 
口 unRewardsByRound 
口 unDelegatesByRound 
Private methods-…-……………………-------- 
四 RoundChanges (round) 


© loaded () 

© calc (height) 

© getVotes (round, cb) 

© flush (round, cb) 

® directionSwap (direction, lastBlock cb) 
® backwardTick (block, previousBlock cb) 
© tick (block cb) 

© sandboxApi (call, args, cb) 


onBind (scope) 
onBlockchainReady0 
onFinishRound (round) 
cleanup (cb) 
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图 17-1 亿 书 DPoS 机 制 相关 类 图 及 其 关联 关系 


如 图 17-2 所 示 。 


[ 


Datebase 


© address: String © mem_accounts2contacts © mem_accounts2U delegates 
2 ek © accountid' String © accountld: String 
o blockld: String © dependentId: String © dependentId: String 


o round: BigInt 
* 


accountId accountid 


© mem_accounts 


© username: String 

© isDelegate: BigInt 

© uisDelegate: BigInt 

© secondSignature: BigInt 
© u_secondSignature: BigInt 
© u_username: String 

© address: String 

© publickey Binary 

© secondPublicKey: Binary 
© balance: BigInt 

© u_balance: BigInt 

O vote: BigInt 

© rate: BigInt 


© mem _accounts2u contacts ldsiesates le © mem_accounts2delegates 
3 大 accountid © contacts: Text accountld * 3 


© accountld: String re © accountid: String 


?eeriertit sre te ?sepemierid Stine 


© ufollowers: Text 

© multisignatures: Text 
© u_multisignatures: Text 
© multimin: BigInt 

© u_multimin: BigInt 

© multilifetime: BigInt 
© umultilifetime: BigInt 
© blockld: String 

© nameexist: Boolean 

© u_nameexist: Boolean 
© producedblocks: BigInt 
© missedblocks: BigInt 
© virgin: Boolean 

o fees: BigInt 

O rewards: BigInt 


accountId accountid 


* 
© mem_accounts2multisignatures © mem_accounts2u_multisignatures 
© accountld: String © accountld: String 
© dependentId: String © dependentld: String 
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图 17-2 ”与 受托 人 相关 的 数据 库 表格 关联 关系 图 


17.3 ”解读 


在 币 圈 ， 如 果 不 知道 “拜占庭 将 军 问题 ”， 那 说 明 您 还 没有 发 现 问题 的 本 质 。 但 是 要 想 理解 这 个 问题 ， 如 果 没 有 高 等 数学 和 计算 机 编程 的 基础 ， 则 不 是 一 件 简单 的 事情 。 本 节 就 从 “拜占庭 将 军 问 


题 ” 的 故事 讲 起 ， 了 解 一 下 这 个 概念 的 由 来 ， 然 后 对 照 比特 币 的 解决 办 法 ， 引 出 亿 书 机 制 的 实现 。 


17.3.1 ”拜占庭 将 军 问题 


1. 比 特 币 是 怎么 来 的 


首先 我 们 来 猜 一 猜 比特 币 是 如 何 诞生 的 。 在 学 习 一 门 新 技术 的 时 候 ， 我 们 通常 会 感到 很 好 奇 ， 发 明 这 项 新 技术 的 人 是 怎么 想到 要 进行 这 项 发 明 的 呢 ? 同 样 ， 对 于 比特 币 ， 笔 者 曾经 也 很 好 奇 ， 中 本 聪 怎 
么 想到 要 发 明 比 特 币 的 呢 ?” 这 个 包含 大 量 高 科技 的 应 用 可 不 是 一 个 小 工程 ， 一 定 要 有 明确 的 目的 才 行 。 正 是 这 种 好 奇 ， 始 终 督 促 着 我 不 断 地 研究 下 去 。 


算法 是 解决 问题 的 理论 基础 ，“ 和 拜占庭 将 军 问题 ”就 是 针对 分 布 式 共识 算法 提出 来 的 ， 而 这 个 问题 也 是 比特 币 等 区 块 链 产 品 的 核心 问题 。 根 据 比 特 币 白皮书 中 的 描述 ， 大 量 篇 幅 提 到 了 诚实 节点 、 攻 击 
者 等 问题 ， 这 点 类 似 于 古代 战场 的 攻防 对 战 ， 很 多 人 猜测 中 本 聪 或 许 就 是 一 位 专门 研究 这 个 方向 的 大 学 老师 或 研究 人 员 ， 他 解决 了 这 个 问题 ， 写 出 了 相关 论文 ， 并 根据 研究 成 果 推 出 了 产品 原型 一 一 比特 
币 。 所 以 ， 才 会 说 比特 币 仅 仅 只 是 一 项 实验 。 


显然 ， 这 种 猜测 纯 属 马后炮 ， 由 结果 找 原因 ， 毫 无 历史 根据 。 笔 者 在 网 上 搜索 了 一 下 ， 各 种 猜测 还 真 不 少 。 姑 且 避 开 各 种 八卦 内 容 ， 其 中 比较 有 价值 的 是 《比特 金 (BitGold) 白皮书 》， 因 为 它 与 比特 
6 有 惊人 的 相似 之 处 ， 因 此 其 开发 者 尼克 :萨博 (Nick Szabo) 被 认为 很 有 可 能 就 是 中 本 聪 本 人 。 比 特 金 较 比特 币 要 早 ， 它 的 目标 就 是 实现 一 种 不 需要 (或 者 只 需 极 小 的 ) 信用 中 介 的 电子 支付 系统 ， 与 比特 
6 的 目标 基本 一 致 。 


ll 


还 


可 见 ， 通 过 使 用 点 对 点 网 络 、 密 码 学 等 技术 实现 加 密 货 币 的 研究 由 来 已 久 ， 可 以 肯定 的 是 ， 比 特 币 的 初 囊 绝 非 是 单纯 为 了 解决 “拜占庭 将 军 问题 ”那么 简单 。 相 反 ， 为 了 实现 没有 中 介 的 电子 支付 系统 
而 设计 比特 币 ， 倒 是 更 加 合情合理 ， 只 不 过 还 附带 完美 地 解决 了 “拜占庭 将 军 问 题 ”而 已 。 事 实 上 ， 比 特 币 算是 解决 “拜占庭 将 军 ” 问 题 的 一 个 完美 实现 。 


2. 什 么 是 “拜占庭 将 军 问题 


但 是 不 管 怎么 说 ，“ 拜 占 庭 将 军 问题 ”是 比特 币 无 法 逾越 的 一 个 问题 。 该 问题 最 早 是 由 Leslie Lamport 解 决 ， 为 了 提高 宣传 效果 ， 老 先生 在 研究 论文 里 编 了 这 么 一 个 故事 ， 事 实证 明 这 样 做 非常 成 功 ， 
这 个 故事 被 广泛 传播 。 故 事 内 容 是 这 样 的 : 拜占庭 是 东 罗 马 帝国 的 首都 ， 为 了 防御 外 敌 入 侵 ， 周 边 驻扎 了 军队 ， 而 且 每 个 军队 都 分 隔 得 很 远 ， 相 互 独立 ， 将 军 与 将 军 之 间 只 能 靠 信使 来 传递 消息 。 在 战争 期 
间 ， 和 拜占庭 军队 内 所 有 的 将 军 都 必须 达成 一 致 的 共识 (进攻 或 撤退 ) ， 这 样 才 有 胜算 的 把 握 。 但 是 ， 军 队 内 部 有 可 能 出 现 叛徒 ， 他 们 会 干扰 将 军 们 的 决定 。 这 时 ， 在 已 知 有 成 员 上 叛变 的 情况 下 ， 其 余 忠 诚 的 
将 军 应 该 如 何 达成 一 致 的 协议 ，“ 和 拜占庭 将 军 问题 ”就 此 形成 。Lamport 证 明了 在 理想 状态 下 ， 叛 徒 数 为 m 或 更 少 的 时 候 ， 将 军 总 数 只 要 大 于 3m， 忠 诚 的 将 军 就 可 以 达成 一 致 。 


从 技术 上 理解 ，“ 和 拜占庭 将 军 问题 ”是 一 个 分 布 式 系统 容错 性 问题 。 区 块 链 产 品 建立 在 P2P 网 络 之 上 ， 是 典型 的 分 布 式 系统 ， 类 比 一 下 ，“ 将 军 ” 就 是 P2P 网 络 中 的 节点 ，“ 信 使 ”就 是 节点 之 间 的 通 
信 ，“ 进 攻 还 是 撤退 的 决定 ”就 是 需要 达成 的 共识 。 如 果 某 台独 立 的 节点 计算 机 宕 机 、 挤 线 或 被 搞 破坏 的 网 络 攻击 ， 整 个 系统 就 要 停止 运行 ， 那 么 这 样 的 系统 将 会 非常 脆弱 ， 所 以 容许 部 分 节点 出 错 或 被 破 
坏 而 不 影响 整个 系统 的 运行 是 非常 有 必要 的 ， 这 就 需要 算法 理论 上 的 支撑 ， 保 证 分 布 式 系统 在 存在 一 定量 的 错误 节点 的 情况 下 ， 仍 然 能 够 保持 一 致 性 和 可 用 性 。 


笔者 非常 赞同 将 “和 拜占庭 将 军 问 题 ” 与 “两 军 问题 ”的 概念 分 开 ， 两 个 问题 的 本 质 不 同 ， 后 者 重 在 研究 信 差 的 通信 问题 ， 类 似 于 TCP 的 握手 操作 ， 原 则 上 是 没有 解 的 。 而 “拜占庭 将 军 问题 ”是 假定 信 
使 没有 问题 ， 只 是 将 军 中 出 现 了 叛变 的 问题 ， 所 以 二 者 在 本 质 上 是 有 区 别 的 。 不 过 ， 在 实际 的 区 块 链 产品 里 ，“ 信 使 ”的 问题 ， 比 如 通信 中 断 、 被 劫持 等 ， 都 可 以 归 为 “将 军 ” (节点 ) 出 了 问题 ， 理 解 了 
这 一 点 就 可 以 了 ， 因 此 可 以 说 比特 币 完 美 地 解决 了 这 两 个 问题 。 关 于 这 两 者 之 间 的 区 别 ， 请 查看 17.5 节 中 的 《拜占庭 将 军 问 题 深入 探讨 》， 其 作者 对 这 两 个 问题 下 了 不 少 功夫 ， 值 得 一 读 。 


3. 比 特 币 是 如 何 解决 “拜占庭 将 军 问题 ”的 


Lamport 给 出 了 理想 状态 下 的 答案 ， 但 现实 是 复杂 的 ， 比 特 币 是 如 何 解决 的 呢 ? 事实 上 ， 比 特 币 通过 “工作 量 证 明 ” (PoW) 机 制 ， 简 单 地 规范 了 节点 (将 军 ) 的 动作 ， 从 而 轻松 地 解决 了 这 个 问题 。 


首先 ， 维 持 周期 循环 ， 保 证 节点 步调 一 致 。 这 个 世界 上 ， 最 容易 达成 的 就 是 时 间 上 的 共识 ， 至 少 “ 几 点 见面 ” “什么 时 候 谈判 ”这 样 的 问题 很 好 解决 。 比 特 币 有 一 个 算法 难度 ， 会 根据 全 网 算 力 自动 调 
整 ， 以 保证 网 络 一 直 需 要 花费 10 分 钟 来 找到 一 个 有 效 的 散 列 值 ， 并 产生 一 个 新 的 区 块 。 在 这 10 分 钟 内 ， 网 络 上 的 参与 者 发 送 交易 信息 并 完成 交易 ， 最 后 才 会 广播 区 块 信息 。 “拜占庭 将 军 问题 ”的 复杂 之 处 
在 于 “将 军 ” 步 调 不 一 致 ， 比 特 币 杜绝 了 节点 (将军 们 ) 无 限制 、 无 规律 地 发 送 命令 的 状态 。 


其 次 ， 通 过 算 力 竞赛 ， 确 保 网 络 单 点 广播 。 “将军 们 ”如 果 有 个 “带头 大 哥 ”， 事 情 就 好 办 了 。 这 里 的 “带头 大 哥 ” 可 以 简单 地 通过 竞争 而 得 来 ， 举 个 极端 的 例子 ， 说 好 的 8 点 钟 谈 判 ， 那 么 先 到 的 就 
是 “带头 大 哥 ”， 他 可 以 拟定 草稿 ， 其 他 人 到 了 之 后 签字 就 行 了 。 “工作 量 证 明 ” 就 是 一 种 竞赛 机 制 ， 算 力 好 的 节点 会 最 先 完成 一 个 新 区 块 ， 在 那 一 刻 成 为 “带头 大 哥 ”。 它 将 区 块 信息 立即 广播 到 网 络 ， 
其 他 节点 确认 验证 就 是 了 。 比 特 币 通过 时 间 戳 和 数字 签名 实现 了 这 样 的 功能 ， 确 保 在 某 一 个 时 间 点 只 有 一 个 “或 者 几 个 ， 这 种 情况 属于 分 叉 行为 ) 节点 传输 区 块 信息 ， 解 决 了 “将 军 们 ”互相 传送 的 混乱 问 
题 。 


最 后 ， 通 过 区 块 链 ， 使 用 一 个 共同 账本 。 对 于 单个 区 块 ， 上 述 两 条 已 经 可 以 达成 共识 了 。 但 现在 的 问题 是 ， 有 一 个 “叛徒 ” (不 诚实 节点 ) 修改 了 前 面 区 块 的 信息 ， 计 划 把 钱 全 部 划 归 自己 所 有 ， 当 它 
广播 新 区 块 的 时 候 ， 其 他 节点 如 何 通过 验证 ?如 果 大 家 手 里 没有 一 份 相同 的 账本 ， 那 么 肯定 会 无 法 验证 ， 问 题 就 会 陷入 僵局 。 基 于 P2P 网 络 的 BT 技术 是 成 熟 的 ， 同 步 一 个 总 账 是 很 简单 的 事情 。 网 络 中 的 节 
点 ， 在 每 个 循环 周期 内 都 是 同步 的 ， 这 让 每 个 节点 (将 军 ) 做 决策 的 时 候 就 有 了 共同 的 基础 。 如 果 每 个 节点 都 独立 维护 自己 的 账本 ， 那 么 问题 的 复杂 性 将 会 无 法 想象 ， 这 是 更 广泛 基础 上 的 共识 。 


上 述 三 点 内 容 是 比特 币 “ 工 作 量 证 明 ” (PoW) 机 制 解决 “拜占庭 将 军 问题 ”的 答案 ， 也 为 其 他 竞争 币 提供 了 重要 参考 。 事 实 上 ， 无 论 采 取 的 是 什么 样 的 方式 ， 只 要 保证 时 间 统一 、 步 调 一 致 、 单 点 广 
播 、 一 个 链条 就 能 解决 分 布 式 系统 的 “拜占庭 将 军 问 题 ”。 如 果 还 不 能 深刻 理解 这 其 中 的 奥妙 ， 那 么 请 阅读 亿 书 源码 ， 来 研究 DPoS (授权 股权 证 明 ) 机 制 的 具体 实现 ， 去 直观 感受 一 下 吧 。 


17.3.2， 亿 书 DPoSs 机 制 概述 


亿 书 白皮书 描述 了 DPoS (授权 股权 证 明 ) 机 制 的 基本 原理 和 改进 方法 ， 这 里 不 再 重复 。 亿 书 由 受托 人 来 创建 区 块 ， 受 托 人 来 自 于 普通 用 户 节点 ， 首 先 需要 进行 注册 ， 然 后 通过 宣传 推广 ， 寻 求 社区 信任 
并 投票 ， 获 得 足够 多 投票 并 排行 到 前 101 名 的 时 候 ， 才 可 以 被 系统 接纳 为 真正 可 以 处 理 区 块 的 节点 ， 并 获得 铸币 奖励 。 比 特 币 是 通过 计算 机 算 力 来 投票 的 ， 算 力 高 的 自然 得 票 较 多 ， 容 易 获胜 。DPoS 机 制 是 
通过 资产 占 比 (股权 ) 来 投票 的 ， 更 多 地 加 入 了 社区 中 人 的 力量 ， 人 们 为 了 自身 利益 的 最 大 化 会 投票 选择 相对 可 靠 的 节点 ， 相 比 来 说 更 加 安全 和 去 中 心 化 。 整 个 机 制 需 要 完成 如 下 过 程 。 


1) 注册 受托 人 ， 并 接受 投票 。 

:用户 注册 为 受托 人 。 

“ 接受 投票 (票数 必须 排行 前 101 位 ) 。 

2) 维持 循环 ， 调 整 受托 人 。 

“ 块 周期 : 也 称 为 时 段 周 期 ， 每 个 块 需要 10 秒 ，10 秒 为 一 个 时 段 。 


“ 受托 人 周期 : 或 称 为 循环 周期 ， 每 101 个 区 块 为 一 个 循环 周期 。 这 些 块 均 由 101 个 代表 随机 生成 ， 每 个 代表 生成 1 个 块 。 一 个 完整 的 循环 周期 大 概 需 要 1010 秒 (101X10) ， 约 16 分 钟 ; 每 个 周期 结 
前 101 名 代表 都 要 重新 调整 一 次 。 


“ 奖励 周期 : 根据 区 块 链 的 高 度 ， 设 置 里 程 碑 事件 (milestone) ， 在 某 个 时 间 点 调整 区 块 奖励 数量 。 


上 述 循环 中 ， 块 周期 最 小 (10 秒 钟 ) ， 受 托 人 周期 其 次 (16 分钟 ) ， 奖 励 周期 最 大 (347 天 ) 。 


3) 循环 产生 新 区 块 ， 广 播 。 


产生 新 区 块 和 处 理 分 义 等 内 容 已 经 在 第 16 章 中 讲 过 ， 这 里 不 再 歼 述 。 


下 面 就 来 通过 源码 解析 逐个 查看 其 实现 方法 。 


17.3.3 ”注册 受托 人 


注册 受托 人 必须 使 用 客户 端 软件 〈 币 圈 俗 称 钱包 ) ， 因 此 这 项 功能 需要 与 节点 进行 交互 ， 也 就 是 说 客户 端 需要 调用 节点 API。 管 理 受 托 人 的 模块 是 modules/delegates,js， 根 据 前 面 章 节 中 的 经 验 ， 很 容 
易 就 能 找到 该 模块 所 提供 的 AP1: 


"put /": "addDelegate" 


最 终 的 API 信 息 如 下 : 


put /api/delegates 


对 应 的 方法 是 ，modules/delegates.js 模 块 的 addDelegate () 方法 。 该 方法 与 注册 用 户 别名 地 址 等 功能 性 的 交易 没有 区 别 ， 注 册 受 托 人 也 是 一 种 交易 ， 类 型 为 “DELEGATE” (受托 人 ) ， 详 细 过 程 
请 自行 查看 modules/delegatesjs 文 件 第 1017 行 的 源码 ， 逻 辑 分 析 请 参考 第 15 章 相关 小 节 的 内 容 。 


17.3.4 投票 


第 15 章 中 曾经 提 到 过 ， 有 一 种 交易 叫 VOTE， 是 投票 交易 类 型 。 所 有 这 类 功能 性 交易 的 逻辑 都 是 类 似 的 ， 这 里 就 不 再 详细 描述 了 。 需 要 提示 的 是 ， 该 功能 是 普通 用 户 所 具备 的 功能 ， 任 何 普 通用 户 都 有 
投票 的 权利 ， 所 以 将 其 放 在 账号 管理 模块 中 ， 即 “modules/accounts.js” 文 件 里 ， 是 符合 逻辑 的 ， 请 参阅 该 文件 729 行 处 的 “addDelegates () ” 方法。 当然， 从 代码 实现 的 角度 来 说 ， 放 在 
modules/delegates.js 文 件 里 ， 或 者 其 他 地 方 也 都 可 以 实现 相同 的 功能 ， 只 是 逻辑 上 稍 显 混乱 而 已 。 


17.3.5 块 (时 段 ) 周期 


1. 时 间 处 理 


比特 币 的 块 周期 是 10 分 钟 ， 由 工作 量 证 明 机 制 来 智能 控制 ， 亿 书 的 为 10 秒 钟 ， 仅 仅 是 时 间 上 的 设置 而 已 ， 源 码 在 helpers/slotsjs 里 。 这 个 文件 非常 简单 ， 时 间 处 理 统一 使 用 UTC 标准 时 间 (请 参考 第 四 
部 分 中 的 25.1 节 ) ， 创 世 时间 beginEpochTime () 和 getEpochTime (time) 两 个 私有 方法 定义 了 首尾 两 个 时 间 点 ， 其 他 的 方法 都 是 基于 这 两 个 方法 计算 出 来 的 时 间 段 ， 所 以 不 会 出 现时 间 上 不 统一 的 错 


误 。 


2. 编 码 风险 


但 是 ， 唯 一 可 能 出 现 错误 的 地 方 就 是 getEpochTime (time) 方法 ， 查 看 下 面 代码 的 16 行 处 ，new Date () 方法 获得 的 是 操作 系统 的 时 间 ， 这 个 是 可 以 人 为 改变 的 ， 一 般 情况 下 不 会 有 什么 影响 ， 但 是 
个 别 情 况 也 可 能 会 引起 分 叉 行为 〈 第 16 章 中 分 析 过 分 叉 的 原因 ， 其 中 一 个 就 发 生 在 这 里 ) : 


// helpers/slots.js 
function getEpochTime (time) { 


if (time === undefined) { 
// 16 行 
time = (new Date()) .getTime(); 


} 

var d = beginEpochTime (); 

var t = d.getTime (); 

return Math.floor((time - t) / 1000); 


3. 周 期 实现 


从 现在 的 时 间 点 到 创 世 时 间 ， 有 一 个 时 间 段 ， 假 设 其 大 小 为 {t， 那 么 t/10 取 整 ， 就 是 当前 的 时 段 数 (getSlotrNumber () ) ， 这 里 的 10 是 由 constants.slots.interval 设 定 的 ， 见 文件 
helpers/constants.js 25 行 处 的 代码 。 


具体 到 一 个 受托 人 ， 它 处 理 的 前 后 两 个 区 块 时 段 值 的 差 值 应 该 是 受托 人 总 数 ， 这 里 是 101， 这 个 值 是 由 constants.delegates 设 定 的 ， 见 文件 helpers/constants,js 22 行 处 的 代码 。 因 
此 ，getLastSlot () 方法 (helpers/slots.js 文 件 54 行 处 的 代码 ) 返回 的 是 受托 人 最 新 的 时 段 值 。 


4 如 何 使 


块 周期 是 其 他 周期 的 基础 ， 但 是 这 里 的 代码 并 不 包含 任何 区 块 、 交 易 等 关键 信息 。 这 里 隐 含 的 关联 关系 就 是 区 块 、 交 易 等 信息 的 时 间 戳 。 只 要 知道 了 任何 一 个 时 间 戳 ， 其 他 的 信息 就 可 以 使 用 这 里 的 方 
法 简单 计算 出 来 。 典 型 的 使 用 就 是 modules/delegates.js 文 件 里 的 方法 privated.getBlockSlotData () (470 行 处 ) ， 代 码 已 在 第 16 章 中 展示 过 ， 该 方法 为 新 区 块 提 供 了 密 钥 对 和 时 间 戳 。 


外 ， 第 16 章 也 提 到 过 程序 设 定 每 秒 钟 (744 行 处 设 定 的 1000 毫 秒 ) 调用 一 次 “privated.loop () ”方法 用 来 产生 新 区 块 ， 但 是 因为 loop () 方法 并 非 每 次 都 能 成 功 运行 ， 所 以 实际 运行 起 来 是 在 10 秒 
内 找到 需要 的 受托 人 并 产生 一 个 区 块 。 


5. 参 数 可 调整 吗 


很 多 小 伙伴 会 问 ， 为 什么 一 定 是 10 秒 ， 其 他 的 值 可 以 吗 ? 为 什么 是 101 个 受托 人 ? 201 个 可 以 吗 ? 回答 都 是 可 以 的 。 笔 者 认为 这 个 块 周期 如 果 提高 到 20 或 30 或 许 会 更 好 (需要 进一步 验证 ) ， 可 能 更 有 
利于 SQLite 数 据 库 ， 也 会 降低 通胀 比率 (后 文中 有 详细 分 析 ) 。 对 于 计算 机 而 言 ， 数 据 库 /O 操 作 是 耗 时 大 户 ，10 秒 的 间隔 可 以 提高 处 理 交 易 的 数量 ， 但 也 会 造成 数据 库 /O 无 法 正确 完成 ， 所 以 这 个 值 是 
力 测试 的 经 验 值 。 


于 


至 于 受托 人 的 数量 也 是 如 此 。 使 用 极限 思维 的 方法 ， 让 受托 人 的 数量 减少 到 1， 效 率 虽 然 提高 了 ， 但 是 单 点 系统 很 容易 受到 攻击 ， 安 全 性 受到 的 威胁 也 增加 到 了 无 限 大 ， 那 么 查找 受托 人 的 方法 将 一 直 运 
行 下 去 ， 结 果 将 是 系统 性 能 降 到 0。 所 以 ， 这 个 数字 也 是 一 个 经 验 值 ， 可 以 根据 实际 情况 进行 适当 调整 。 特别 是 那些 要 做 DAPP 市 场 的 应 用 ， 更 应 该 考虑 进行 适当 的 变更 。 


17.3.6 受托 人 (循环) 周期 


为 了 保证 安全 性 ， 亿 书 规 定 受托 人 每 轮 都 要 变更 一 次 ， 以 确保 那些 不 稳定 或 正在 做 坏事 的 节点 被 及 时 剔除 出 去 。 另 外 ， 尽 管 系统 会 随机 找寻 受托 人 产生 新 块 ， 但 是 在 一 个 轮 次 内 ， 每 个 受托 人 都 有 机 会 
产生 一 个 新 的 区 块 (会 获得 奖励 ) 并 广播 ， 这 一 点 与 比特 币 每 个 节点 都 要 通过 工作 量 证 明 (PoW) 机 制 竞争 来 获得 广播 权 相 比 ， 要 简单 得 多 。 


这 样 ， 亿 书 的 每 个 区 块 都 会 与 特定 的 受托 人 关联 起 来 ， 其 高 度 (height) 和 产生 器 公 钥 (Generator Public Key，GPK) 必然 是 严格 对 应 的 。 块 高 度 可 以 轻松 找到 当前 块 的 受托 人 周期 
(modules/round.js 文 件 51 行 处 的 calc () 方法 ) ，generatorPublicKey 代 表 的 就 是 受托 人 。 而 单 点 广播 的 权限 自然 也 已 经 确定 ， 具 体 代码 见 modules/round.js 文 件 。 


这 里 需要 重点 关注 的 是 该 文件 的 tick () 和 backwardTick () 方法 。tick 的 英文 意思 是 “滴答 声 或 做 标记 ”， 如 果 大 家 开发 过 股票 分 析 软件 ， 在 金融 领域 tick 还 有 “数据 快照 ”的 含义 ， 意 思 是 某 个 时 段 
的 交易 数据 。 笔 者 个 人 觉得 ， 这 里 的 tick 就 是 这 个 意思 ， 即 指 在 一 个 受托 人 周期 内 某 个 受托 人 的 数据 快照 。 相 关 数 据 都 存储 在 mem_round 表 里 ， 程 序 退出 时 会 被 清空 。 具 体 代码 如 下 : 


// modules/round.js 
// 224 行 
Round.prototype.tick = function (block, cb) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
/7 229 行 
modules .accounts .mergeAccountAndGet ({ 
publicKey: block.generatorPublicKey, 
Producedblocks: 1, 
blockId: block.id, 
round: modules.round.calc (block.height) 
}, function (err) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
if (round !== nextRound || block.height == 1) { 
if (privated.delegatesByRound[round] .length 一 constants.delegates || 
block.height == 1 || block.height == 101) { 
var outsiders = []; 
// 255 行 
async.series([ 
// 256 行 ， 找 到 那些 不 在 当前 轮 次 里 的 节点 
function (cb) { 
if (block.height != 1) { 
// 258 行 ，generateDelegateList () 方 法 可 以 查询 数据 库 里 投票 排行 前 101 的 节点 ， 不 过 当前 可 能 已 经 改变 ， 这 里 需要 把 它们 找 出 来 
modules .delegates .generateDelegateList (block.height, function (err, roundDelegates) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
for (var i = 0; i < roundDelegates.length; i++) { 
if 
(privated.delegatesByRound[round] .indexOf (roundDelegates[i]) == -1) { 
outsiders.push (modules.accounts.generateAddress-ByPublicKey (roundDelegates [i])):; 


} 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
}, 


// 把 缺失 的 块 暂时 保存 到 mem_accounts 表 里 
function (cb) { 
if (!outsiders.length) { 
return cb(); 
} 


Var escaped = outsiders.map (function (item) { 


return ww + item + ™'™, 

])3 

library.dbLite.query('update mem accounts set missed-blocks = missedblocks + 1 where address in (' + escaped.join(',') + ')', function (err, data) { 
cb (err); 


D); 
}, 


// 一 开始 就 通过 merge () 方 法 向 mem_round 表 肖 
方法 查询 出 来 ， 并 依次 更 新 到 mem_accounts 表 里 
function (cb) { 
self.getVotes (round, function (err, votes) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
async.eachSeries (votes, function (vote, cb) { a 
library.dbLite.query('update mem accounts set vote = vote + $amount where address = $address', { 
address: 
modules .accounts .generateAddressByPublic-Key (vote.delegate), 
amount: vote.amount 
}, cb): 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
]); 


0 了 记录 ， 这 里 先 将 getVotes () 


}, 
// 上 述 变 化 处 理 完毕 后 ， 接 着 处 理 余额 、 费 用 和 奖励 变化 


function (cb) { 
Var roundChanges = new RoundChanges (round); 


async.forEachOfSeries (privated.delegatesByRound[round], function (delegate, index, cb) { 
Var changes = roundChanges .at (index); 


modules .accounts .mergeAccountAndGet ({ 

publicKey: delegate, 

balance: changes.balance, 

u balance: changes.balance, 

blockId: block.id, 

round: modules.round.calc (block.height), 

fees: changes.fees, 

rewards: changes.rewards 
}, function (err) { 

http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
}, 


// 最 后 ， 再 一 次 更 新 mem accounts 的 投票 数据 ， 若 没有 问题 就 结束 本 轮 循环 
(推送 客户 端 改变 ) ， 弄 清除 mem_round 记录 的 信息 
function (cb) { 
self.getVotes (round, function (err, votes) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
async.eachSeries (votes, function (vote, cb) { 本 
library.dbLite.query('update mem accounts set vote = vote + $amount where address = $address', { 
address : 
modules .accounts .generateAddressByPublic-Key (vote.delegate)， 
amount: vote.amount 
}, cb); 
}, function (err) { 
library.bus.message ('finishRound', roung); 
self.flush (round, function (err2) { 
cblerr || err2); 
]); 
]) 
})s 
} 


], function (err) { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


229 行 处 的 modules.accounts.mergeAccountAndGet () 方法 实际 上 是 调用 logic/account.merge () 方法 (请 自行 查阅 文件 |ogic/account.js) ， 把 这 里 的 数据 插入 到 以 “mem-” 开 头 的 数据 库 表 
里 ， 用 于 处 理 与 账户 相关 的 一 些 数 据 ， 该 方法 比较 混乱 ， 系 统 需 要 频繁 处 理 ， 因 此 对 性 能 有 较 大 的 影响 ， 亿 书 将 在 以 后 的 版 本 里 做 进一步 优化 。 


255 行 处 使 用 了 async.series 方 法 ， 顺 序 执行 了 一 些 函数 ， 具 体 情况 请 看 代码 中 的 注释 ， 这 里 不 再 蓝 述 。 


backwardTick () 方法 是 反方 向 处 理 ， 属 于 回 退 操作 ， 请 自行 查阅 分 析 。 


17.3.7 ”奖励 周期 


该 周期 主要 针对 块 奖励 进行 设置 ， 与 比特 币 


的 情况 类 似 ， 亿 书 的 块 奖励 也 会 遵循 一 定 的 规则 。 大 致 的 情况 是 这 样 的 : 第 一 阶段 (大 概 1 年 ) 奖励 5EBC ( 亿 书 币 ) / 块 ， 第 二 年 奖励 


4EBC ( 亿 书 币 ) / 块 ，4 年 之 后 降 到 1EBC ( 亿 书 i 


600 万 ， 以 后 每 阶段 300 万 。 这 种 适当 通胀 的 情况 是 DPoS 机 制 的 一 个 特点 ， 也 是 为 了 给 节点 提供 奖励 ， 争 取 更 多 用 户 为 网 络 做 贡献 。 


6) / 块 ， 以 后 永远 保持 在 1EBC/ 块 ， 所 以 总 量 始终 在 少量 增发 ( 亿 书 正式 上 线 的 产品 可 能 会 做 适当 调整 ， 这 里 仅 作 测试 参考 之 | 


具体 的 增发 量 很 容易 计算 ， 第 一 阶段 时 间 长 度 =rewards.distance*10 秒 / (24*60*60) =347.2 天 ， 增 发 量 =rewards.distance*5=3000000*5=1500 万 。 第 二 阶段 1200 万 ， 第 三 阶段 900 万 ， 第 四 阶段 


很 多 人 担心 这 种 通胀 会 降低 代 币 的 价值 ， 影 响 代 币 的 价格 。 事 实 上 ， 对 于 拥有 大 量 侧 链 应 


章 肘 的 问题 ， 对 整个 生态 系统 来 说 都 不 是 一 件 好 二 


具体 代码 见 文件 helpers/milestones.js， 该 文件 的 编码 很 简 生 


给 定 某 个 块 高 度 height 


计算 相对 高 度 值 parseHelght(helght) 


location> 最 大 里 程 碑 ( 4 ) 


最 大 里 程 原 (4 ) 


获得 当前 所 处 转折 点 


计算 当前 应 该 获得 的 奖励 


到 。 这 种 情况 可 以 通过 最 近 以 太 坊 (Ethereum) 的 运行 情况 反映 出 来 ， 特 别 是 侧 链 应 用 使 


的 平台 产品 来 说 ， 一 定 要 保证 有 足够 多 的 代 币 供 各 种 侧 链 产品 使 用 ， 不 然 会 造成 主 链 和 侧 链 绑 定 紧密 、 互 相 
主 链 代 币 众 筹 时 就 更 不 必 说 了 ， 此 消 彼 长 ， 价 格 波动 剧烈 。 


E， 都 是 一 些 算术 运算 ， 请 自行 浏览 。 这 里 简单 给 出 流程 图 ， 如 图 17-3 所 示 。 


这 里 预先 设 定 了 转折 点 的 间隔 量 distance = 3 000 000 
以 及 每 个 间隔 的 起 点 rewardOffset = 60 480， 这 样 ， 
就 能 够 简单 的 确认 该 高 度 处 在 哪个 间隔 期 内 ， 即 : 


location = (height-rewardOffset)/distance 


其 实 这 里 有 个 简单 的 逻辑 : 当 未 达到 奖励 起 点 位 置 时 ， 
奖励 为 0 ; 大 于 设 定 最 大 里 程 碑 位 置 时 ， 奖 励 都 按 最 大 
里 程 碑 奖 励 额度 计算 


17-3 ”奖励 周期 计算 流程 图 


唯一 需要 提醒 的 是 ， 代 码 有 一 处 非常 隐 星 的 Bug， 涉 及 了 parselnt () 方法 的 使 用 (请 参考 25.2 节 ) ， 特 别 是 第 26 行 。 不 过 该 Bug 对 系统 的 影响 非常 微弱 ， 仅 仅 在 个 别 区 块 高 度 值 的 时 候 才 会 出 现 几 
次 ， 比 如 : 出 现 类 似 parselnt (2/300000000) =6 的 情况 ， 而 影响 的 也 仅仅 是 奖励 的 数量 ， 不 会 影响 整个 产品 正常 运行 ( 亿 书 将 在 后 面 的 版 本 中 做 进一步 修改 ) 。 


17.4 总结 


VGN= 口 


本 章 介绍 了 “和 拜占庭 将 军 问题 ”及 比特 


6 解决 思路 ， 并 沿 着 这 个 思路 阅读 了 亿 书 的 相关 源码 ， 内 容 涉及 多 个 源 文 件 。 其 中 ， 因 为 篇 幅 所 限 没 有 详细 提供 大 量 的 代码 细节 ， 需 要 读者 自行 查阅 。 从 源码 设 


计 上 来 说 ， 这 一 部 分 的 源码 还 需要 更 多 的 优化 设计 。 从 本 章 的 内 容 来 说 ， 对 共识 机 制 的 讲述 还 远 远 不 够 ， 这 里 仅仅 起 到 抛砖引玉 的 作用 ， 需 要 更 多 的 探索 和 讨论 。 


17.5 参考 


《比特 币 白皮书 : 一 种 点 对 点 的 电子 现金 系统 》: http://www.8btc.com/wiki/bitcoin-a-peer-to-peer-electronic-cash-system 


尼克 .萨博 《比特 金 (BitGold) 》 


白皮书 : http://www.8btc.com/bit-gold 


百度 百科 关于 “拜占庭 将 军 问题 ”的 描述 (混淆 了 “两 军 问题 ”) : http://baike.baidu.com/link?url=BMJI6w7U9VWdYVpMS5OqG-y3m1Ez6g8b0- 
PygRuCg2S65Al72y382s6Nuqhc1zCmclXzoFOALMIwimMd1dTCVa 


《分 布 式 共识 难题 (英文 ) 》: https://wikitech.wikimedia.org/wiki/https:_Browser_ Recommen-dations 


《拜占庭 将 军 问题 深入 探讨 》: http://www.8btc.com/baizhantingjiangjun 


第 四 部 分 开发 实践 


区 块 链 开 发 的 涉及 面 很 广 ， 前 面 三 个 部 分 从 概念 到 源码 讲述 了 区 块 链 开 发 的 整个 底层 架构 体系 ， 不 过 并 未 涉及 客户 端 开发 ， 对 一 些 技 术 细 节 也 不 够 深入 ， 这 对 于 使 用 Node.js 开 发 区 块 链 产 品 来 说 还 远 远 
不 够 。 本 部 分 将 弥补 这 些 不 足 ， 把 亿 书 开发 过 程 中 需要 了 解 和 掌握 的 技术 ， 从 前 端 到 后 台 ， 细 细 梳 理 ， 既 作为 知识 分 享 ， 也 作为 入 门 文档 。 


学 习 编 程 是 一 个 循序 渐进 的 过 程 ， 与 掌握 增 量 开发 的 原理 类 似 ， 和 急躁 不 得 。 本 部 分 的 内 容 是 根据 源码 解读 过 程 ， 拣 选 技术 重点 逐步 整理 出 来 的 ， 所 以 整体 内 容 并 不 系统 ， 章 节 分 布 也 比较 随意 ， 可 以 单 
独 阅读 ， 也 可 以 结合 前 面 几 个 部 分 特别 是 源码 部 分 的 内 容 一 并 阅读 。 


本 部 分 的 内 容 仍 以 实用 为 目的 ， 先 后 介绍 了 几 个 具体 的 开发 实例 ， 都 是 可 以 应 用 于 实际 的 小 工具 ， 因 此 命名 为 开发 实践 。 如 果 一 定 要 给 这 几 篇 文章 归 类 的 话 ， 第 18 一 19 章 属于 编程 方法 论 的 内 容 ， 介 绍 
了 使 用 函数 式 编程 的 技巧 ， 第 20 一 21 章 是 命令 行 开 发 以 及 使 用 async 进 行 流程 控制 的 内 容 ， 第 22 一 23 章 是 客户 端 开 发 ， 第 24 章 是 密码 学 ， 第 25 章 是 优化 ， 第 26 章 是 测试 。 


区 块 链 产品 通常 是 官方 打包 好 的 桌面 应 用 ， 只 要 下 载 安装 即 可 ， 不 需要 部 署 ， 因 此 原本 已 经 写作 完成 的 “使 用 PM2 进 行 部 署 ” 的 文章 没有 收录 进来 。 


第 18 章 ”函数 式 编程 入 门 经 典 


虽然 大 家 已 经 被 面向 对 象 编程 (Object-Oriented Programing) 的 概念 洗脑 了 ,但 很 明显 的 是 ， 这 种 编程 方式 在 JavaScript 里 非常 筑 拙 ， 这 种 语言 里 没有 类 可 以 用 ， 社 区 采取 的 变通 方法 不 止 三 种 ,还 
应 对 忘记 调用 new 关 键 字 后 的 怪异 行为 ， 真 正 的 私有 成 员 只 能 通过 闭 包 (closure) 来 实现 ， 而 大 多 数 情况 下 ， 就 像 我 们 在 亿 书 代码 里 所 做 的 那样 ， 把 私有 方法 放 在 一 个 privated 变 量 里 ,视觉 上 区 分 一 下 
而 已 ， 但 本 质 上 其 并 非 真正 的 私有 方法 。 对 于 大 多 数 人 来 说 ， 函 数 式 编程 看 起 来 才 更 加 自然 。 而 且 ， 在 Nodejs 的 世界 里 ， 大 量 的 回调 函数 是 数据 驱动 的 ， 使 用 函数 式 编程 更 加 容易 理解 和 处 理 。 


函数 式 编程 远 远 没 有 面向 对 象 编程 那么 普及 ， 本 章 借鉴 了 几 篇 优秀 文档 ( 见 18.6 节 中 的 相关 链接 ) ， 结 合 亿 书 的 项 目 实践 和 个 人 体会 ， 汇 总 了 一 些 平时 经 常会 用 到 的 函数 式 编程 思路 ， 为 更 好 地 优化 和 
设计 亿 书 做 好 准备 。 本 章 的 内 容 包 括 了 函数 式 编程 的 基本 概念 、 主 要 特点 和 编码 方法 等 ， 其 中 的 一 些 代码 实例 主要 参考 了 《mostly adequate guide》、folktale.js 和 ramda.js 的 相关 代码 ，18.6 节 也 提供 了 
它们 的 链接 ， 请 大 家 自行 参考 和 学 习 。 如 果 想 运行 文中 的 代码 ， 请 提前 安装 ramda 等 相应 的 第 三 方 组 件 。 


18.1 什么 是 函数 式 编程 


简单 来 说 ，“ 函 数 式 编程 ”与 “面向 对 象 编程 ”一 样 ， 都 是 一 种 编写 程序 的 方法 论 。 它 属于 “结构 化 编程 ”的 一 种 ， 主 要 思想 是 以 数据 为 思考 对 象 ， 以 功能 为 基本 单元 ， 把 程序 尽量 写成 一 系列 嵌 套 的 


下 面 就 从 一 个 简单 的 例子 开始 ， 来 体会 其 中 的 奥妙 和 优势 。 这 个 例子 来 自 于 mostly-adequate-guide， 是 一 个 海 网 程序 ， 鸟 群 合 并 则 变 成 一 个 更 大 的 鸟 群 ， 繁 殖 则 增加 鸟 群 的 数量 ， 所 增加 的 数量 就 是 
它们 繁殖 出 来 的 海鸥 的 数量 。 


18.1.1 面向 对 象 的 编码 方式 


下 面 就 来 看 看 这 个 示例 的 代码 : 


var Flock = function(n) { 
this.seagulls = n; 
] 7 


Flock.prototype.conjoin = function (other) { 
this.seagulls += other.seagulls; 
return this; 


}; 


Flock.prototype.breed = function(other) { 
this.seagulls = this.seagulls * other.seagulls; 
return this; 


让 


Var flock a = new Flock(4); 
var flock b = new Flock(2); 
Var flock c = new Flock(0); 


Var result = 
flock a.conjoin (flock c) .breed (flock b) .conjoin (flock a.breed (flock b) ) .seagulls; 
/1/ > 32 = 和 - 


按照 正常 的 面向 对 象 语言 的 编码 风格 ， 上 面 的 代码 好 像 没有 什么 错误 ， 但 是 运行 结果 却 是 错误 的 ， 正 确 的 答案 是 16， 但 这 里 是 32， 这 是 因为 flock_a 的 状态 值 seagulls 在 运算 过 程 中 不 断 发 生 着 改变 。 别 
的 先 不 说 ， 如 果 flock_a 的 状态 始终 保持 不 变 ， 那 么 结果 就 不 会 是 错误 的 。 


这 类 代码 内 部 的 可 变 状态 非常 难以 追踪 ， 出 现 这 类 看 似 正 常 ， 实 则 错误 的 代码 ， 对 整个 程序 来 说 将 是 致命 的 。 


18.1.2 ”函数 式 编程 的 方式 


将 上 述 示例 代码 以 函数 式 编程 的 方式 来 表示 ， 代 码 如 下 : 


Var conjoin = function (flock x, flock y) { return flock x + flock y }; 
Var breed = function (flock x, flock y) { return flock x * flock y }; 


var flock a = 4; 
var flock b = 2; 
var flock c = 0 


Var result = conjoin (breed(flock b, conjoin(flock a, flock c)), breed(flock a, flock b)); 
// =>16 


先 不 用 考虑 其 他 场景 ， 至 少 就 这 个 例子 而 言 ， 这 种 写法 就 简洁 优雅 得 多 。 从 数据 的 角度 来 考虑 ， 这 种 方式 的 逻辑 也 更 简单 直接 ， 不 过 是 简单 的 加 (conjoin) 和 乘 (breed) 的 运算 而 已 。 


18.1.3 ”函数 式 编程 的 延伸 


在 进行 函数 编程 时 ， 函 数 名 越 直 白 越 好 ， 下 面 再 来 修改 一 下 : 


Var add = function(x, y) { return x+y}; 
Var mltiply = function(x, y) { return x *y}; 


var flock a= 4; 
var flock b = 2; 
var flock c = 0 


Var result = add (multiply(flock b, add(flock a, flock c)), multiply(flock a, flock b)) 
// =>16 后 四 加 本 - 


这 么 一 来 ， 会 发 现 这 里 还 能 运用 小 学 学 过 的 运算 定律 : 


// 结合 和 

add (add (x, y), z) 一 add (x,add (y, 2z)); 
// 交换 律 

add (x, y) =add(y, x); 


// 同一 律 

add (x,0) == x; 

// 分 配 律 

multiply (x,add (y, z)) ==add (multiply (x, y),multiply(x, 2z)); 


下 面 再 来 看 看 如 何 运 用 这 些 定律 简化 这 个 海 鸣 小 程序 : 


// 原 有 代码 
add (multiply (flock b,add (flock a, flock c) ) ,multiply(flock a, flock b)); 


// 应 用 同一 律 ， 去 掉 多 余 的 加 法 操作 (agdd (flock a, flock c) 一 flock a) 
aqdd (multiply (flock b, flock a),multiply(flock a, flock b)); 


// 再 应 用 分 配 律 
multiply (flock b,add (flock a, flock a)); 


进行 到 这 里 ， 程 序 就 变 得 非常 有 意思 了 ， 即 使 是 更 加 复杂 的 应 用 ， 也 能 够 确保 结果 是 可 以 预期 的 ， 这 就 是 函数 式 编程 。 


18.2 ”函数 式 编程 的 优势 


1) 易于 开发 : 代码 简洁 ， 大 大 降低 了 开发 的 成 本 。 


从 上 面 的 示例 代码 中 就 可 以 体会 到 这 一 点 。 使 用 函数 式 编程 ， 可 以 充分 发 挥 javaScript 语 言 自身 的 优点 ， 每 一 个 函数 都 是 一 个 独立 的 单元 ， 便 于 调试 和 测试 ， 也 方便 模块 化 组 合 ， 代 码 量 少 、 开 发 效率 
高 。 有 人 比较 过 (C 语 言 与 Lisp 语 言 ， 实 现 同样 功能 的 程序 ， 极 端 情况 下 ，Lisp 代 码 的 长 度 可 能 是 C 代 码 的 1/20。 


2) 易于 分 享 : 更 接近 自然 语言 ， 代 码 即 文档 。 上 面 使 用 分 配 律 之 后 的 代码 multiply (flock_b，add (flock_a，flock_a) ) ， 完 全 可 以 改 成 下 面 这 样 : 


add (flock a, flock a) .multiply(flock b) // = (flock a + flock a) * flock b 


特别 是 下 面 这 样 的 句 式 ， 如 果 是 用 惯 了 Ruby on Rails 的 小 伙伴 ， 可 能 会 更 加 熟悉 下 面 的 语句 : 


User.all() .sortBy('name') .limit (20) 


3) 性 能 更 高 : 能 够 实现 “并 发 编程 。 (concurrency) 。 逊 数 式 编程 不 会 依赖 、 也 不 会 改变 外 界 的 状态 ， 相 同 的 输入 总 会 获得 相同 的 输出 ， 因 此 不 存在 “ 锁 ” 线 程 的 问题 。 也 不 必 担 心 一 个 线程 的 数 
据 ,， 会 被 男 一 个 线程 修改 ， 所 以 可 以 放心 地 把 工作 分 摊 到 多 个 线程 实现“ 并 发 编程 。。 目 前 的 计算 机 基本 上 都 是 多 核 的 了 ， 多 线程 应 用 将 是 常态 ， 亿 书 客户 端 也 会 考虑 优化 线程 服务 ， 提 高 软件 性 能 ， 改 
善 用 户 体验 ， 这 些 将 会 非常 有 帮助 。 


4) 部 署 简单 : 热 部 署 和 热 升级 。 函 数 式 编程 没有 副作用 ， 只 要 接口 没有 发 生变 化 ， 那 么 函数 内 部 代码 的 改变 对 外 部 就 没有 任何 影响 。 所 以 ， 可 以 在 运行 状态 下 直接 升级 代码 ， 不 需要 重启 ， 也 不 需要 停 
机 。 这 点 对 于 每 秒 要 处 理 大 量 交 易 的 区 块 链 产 品 来 说 ， 尤 为 重要 。 亿 书后 续 将 会 实现 每 个 节点 的 热 部 署 和 热 升级 ， 使 节点 的 建立 和 维护 实现 零 难度 。 


18.3 ”函数 式 编程 的 基本 原则 


函数 式 编 程 的 基本 原则 ， 总 的 来 说， 就 是 “正确 地 写 出 正确 的 函数 ”。 这 句 话 有 点 扼 口 ， 不 过 我 们 写 了 太 多 面向 对 象 的 代码 ， 可 能 已 被 “毒害 ”得 太 深 ， 不 得 不 下 点 猛 药 ， 说 点 狠 话 ， 不 然 记 不 住 。 函 
数 式 编程 ， 当 然 是 以 函数 为 主角 ， 函 数 在 这 里 被 称 为 “一 等 公民 ”， 特 别 是 对 于 Javascript 语 言 来 说 ， 可 以 像 对 待 任何 其 他 数据 类 型 一 样 对待 函 数 一 一 把 它们 存在 数组 里 ， 当 作 参 数 传递 ， 赋 值 给 变量 ， 等 
等 。 但 是 ， 说 起 来 容易 ， 真 正 做 起 来 ， 并 非 每 个 人 都 能 轻松 做 到 。 下 面 是 写 出 正确 函数 的 几 个 原则 。 


18.3.1 直接 把 函数 赋值 给 变量 


人 注意“ 几 是 使 用 retum 返 回 画 教 调用 的 ， 都 可 以 去 控 这 个 间接 包 诸 层 ， 最 终 连 参数 和 括号 一 起 去 挤 ! 


以 下 代码 均 来 自 npm 上 的 模块 包 : 


// 太 傻 了 


Var getServerStuff = function(callback){ 
return ajaxCall (function (json){ 
return callback (json); 


]) 7 
}; 


// 这 才 像 样 


Var getServerStuff = ajaxCall; 


世界 上 到 处 都 充斥 着 这 样 的 垃圾 Ajax 代码 。 以 下 是 上 述 两 种 写法 等 价 的 原因 : 


// 这 行 


return ajaxCall (function (json) { 
return callback (json) 7 


// 等 价 于 这 行 


return ajaxCall (callback); 


// 那么 ， 重 构 下 getServerStuff 
Var getServerStuff = function(callback){ 
return ajaxCall (callback); 


// http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/.. .就 等 于 
var getServerStuff = ajaxCall; // <-- 看 ， 没 有 括号 哦 


18.3.2 ”使 用 最 普 适 的 方式 命名 


函数 属于 操作 ， 命 名 最 好 简单 、 直 白 ， 且 能 体现 功能 特性 ， 比 如 add 等 。 参 数 是 数据 ， 最 好 不 要 限定 在 特定 的 数据 上 ， 比 如 articles， 这 样 就 能 让 写 出 来 的 函数 更 加 通用 ， 和 避免 


的 代码 : 


// 只 针对 当前 的 博客 


var validArticles = function(articles) { 
return articles.filter (function (article){ 


return article !=— null && article !== undefined; 


]) 7 
} 


// 对 未 来 的 项 目 友好 太 多 
Var compact = function (xs) { 
return xs.filter (function (x) { 
return x !== null && x !== undefined; 


}); 
}; 


和 E 复 造 轮子 。 例 如 ， 如 下 


18.3.3 ”避免 依赖 外 部 变量 


不 用 依赖 外 部 变量 和 环境 ， 就 能 确保 写 出 来 的 函数 是 纯 函 数 ， 即 相同 的 输入 能 得 到 相同 输出 的 函数 。 比 如 slice 和 splice， 这 两 个 函数 的 作 有 


输入 它 能 够 保证 总 是 返回 相同 的 输出 。 而 splice 会 “ 吐 烂 


再 如 : 


// 不 纯 的 


var minimum = 21; 


Var checkAge = function(age) { 


这 


// 纯 的 


return age >= minimum; 


Var checkAge = function(age) { 
var minimum = 21; 


}; 


return age >= minimum; 


” 调 | 


它 的 那个 数组 ， 然 后 再 “ 吐 ” 出 来 ， 即 这 个 数组 被 永久 地 改变 了 。 


一 样 ， 但 方式 不 同 ，slice 符 合 纯 函 数 的 定义 ， 是 因为 对 相同 的 


在 上 面 不 纯 的 版 本 中 ，checkAge 的 结果 取决 于 minimum 这 个 外 部 可 变 变量 的 值 (系统 状态 值 ) 。 输 入 值 之 外 的 因素 能 够 干扰 checkAge 的 返回 值 ， 产 生 很 多 副作用 ， 不 仅 会 让 它 变 得 不 纯 ， 还 会 导致 


我 们 每 次 思考 整个 软件 的 时 候 都 痛苦 不 堪 ， 

系统 状态 等 ， 总 之 ， 就 是 在 计算 结果 的 过 程 中 ， 它 们 会 导致 系统 状态 发 生变 化 ， 或 者 与 外 部 世界 进行 了 可 观察 的 交互 。 
在 数学 领域 ， 函 数 是 这 么 定义 的 〈 请 参考 百度 百科 上 函数 的 定义 ) : 一 般 地 ， 在 一 个 变化 过 程 中 ,假设 有 两 个 变量 x 

白 一 点 说 就 是 ， 函 数 是 不 同 数值 之 间 的 特殊 关系 ， 即 对 于 每 一 个 输入 值 x 返回 且 只 返 


可 测试 性 、 合 理性 、 并 行 代码 等 很 多 好 处 。 


18.3.4” 面 对 this 值 时 ， 小 心 加 小 心 


应 尽 可 能 地 避免 使 
如 : 


this, 


Var fs =require('fs'); 


// 太 可 怕 了 


因为 在 函数 式 编程 中 根本 


fs.readFile('freaky friday.txt',Db.save); 


// 好 一 点 点 


因为 它 本 身 就 会 产生 很 多 Bug。 这 些 副作用 包括 但 不 限于 更 改 文件 系统 、 往 数 


居 库 插入 记录 、 发 送 一 个 HTTP 请 求 、 打 印 日 志 、 获 取 用 户 输入 、DOM 查 询 、 访 问 


hy， 如 果 对 于 任意 一 个 x 都 有 唯一 一 个 确定 的 y 与 它 对 应 ， 那 么 就 称 y 是 x 的 函数 。 直 


一 个 输出 值 y。 从 这 个 定义 来 看 ， 所 谓 的 纯 函 数 其 实 就 是 数学 函数 。 这 会 给 我 们 带 来 可 缓存 性 、 可 移植 性 、 自 文档 化 、 


不 到 它 。 然 而 ， 在 使 用 其 他 的 类 库 时 ， 却 不 得 不 使 用 它 。 如 果 一 个 底 


fs.readFile('freaky friday.txt',Db.save.bind (Db)); 


把 Db 绑 定 (bind) 到 它 


18.4 ”怎样 进行 函数 式 编程 


本 节 将 汇总 一 些 函数 式 编程 常用 的 工具 和 方法 。 


己 身 上 以 后 ， 就 可 以 随心 所 欲 地 调 有 


它 的 原型 链 式 代码 了 。 


慨 函 数 使 


了 this， 而 | 


目 是 以 函数 的 方式 被 调用 的 ， 那 么 就 要 非常 小 心 了 。 比 


18.4.1 柯 里 化 : 动态 产生 新 函数 


什么 是 柯 里 化 (curry) ? 维基 百科 ( 见 18.6 节 给 + 
说 ， 就 是 只 向 函数 传递 一 部 分 参数 来 调用 它 ， 


这 里 有 两 个 关键 之 处 : 首先 ， 明 确 


的 链接 ) 的 解释 是 ， 柯 里 化 是 指 把 接受 多 
让 它 返 回 一 个 函数 去 处 理 剩 下 的 参数 。 


规则 。 前 面 的 参数 (也 可 以 是 函数 ) 是 规则 ， 相 当 于 新 函数 的 私有 变量 (通过 类 似 闭 包 的 方式 ) 。 


处 理 业务 数据 的 函数 ， 所 以 与 业务 数据 相关 的 参数 ， 最 好 放 在 后 面 。 


柯 里 化 是 函数 式 编程 的 重 
数 就 能 达到 同样 的 目的 ， 而 此 时 一 般 就 会 


技巧 之 一 ,在 使 
到 这 种 方法 。 


来 看 一 个 最 简单 的 例子 : 


var add = function(x) { 
return function(y) { 

return x + Y7 

] 7 

] 7 


var addTenTo = add(10) 7 


addTenTo (2) 7 
/7 12 


各 类 高 阶 函 数 (参数 或 返回 值 为 函数 的 函数 ) 的 时 候 非 常常 见 。 通 常 我 们 


个 参数 的 函数 变换 成 接受 一 个 单一 参数 (第 一 个 ) 的 函数 ， 然 后 返回 接受 剩余 参数 的 新 函数 的 技术 。 通 俗 点 


其 次 ， 明 确 目 的 。 目 的 是 获得 新 函数 ， 而 这 个 新 函数 才 是 真正 用 来 


会 定义 直接 操作 数组 的 函数 ， 因 为 只 需要 内 联 调 


map、sort、filter 及 其 他 函 


这 里 是 自 定义 的 add 函 数 ， 它 接受 一 个 参数 并 返回 一 个 新 的 函数 。 调 
lodash 包 的 curry 方 法 ， 上 面 的 add 方 法 就 会 变 成 像 下 面 这 样 : 


如 , 利 


Var curry = require('lodash') .curry; 


Var add = curry (function(x, y) { 


return x + Y7 


Ds 


下 面 再 来 看 几 个 更 实用 的 例子 : 


add 之 后 ， 返 回 的 函数 就 会 通过 闭 包 的 方式 记 住 add 的 第 一 个 参数 。 还 可 以 借助 工 


使 这 类 函数 的 定义 和 调用 变 得 更 加 容易 。 比 


Var curry = require('lodash') .curry; 


var match = curry (function(what, str) { 


return str.match (what); 


// 1. 普 通 函 数 调用 
match(/\st/g, "hello world"); 
区 


match(/\s+/g) ("hello world"); 
oi | 


// 2. 使 用 柯 里 化 的 新 函数 
var hasSpaces = match(/\s+/g); 


// function (x) { return x.match(/\s+/g) } 


hasSpaces ("hello world"); 
2 


hasSpaces ("spaceless"); 
// null 


// 3. 大 胆 嵌 套 使 用 


Var filter = curry(function(f, ary) 


return ary.filter (f); 


D); 


{ 


Var findHasSpacesOf = filter (hasSpaces); 


// function (xs) 


{ return xs.filter (function (x) 


{ return x.match(/\s+/g) }) } 


findHasSpacesOf (["tori spelling", "tori amos"]); 


// ["tori amos"] 


18.4.2 组合: 自由 组 合 新 函数 


组 合 (compose) 就 是 把 两 个 函数 结合 起 来 ， 生 成 一 个 崭新 的 函数 。 这 点 比较 符合 范畴 学 的 组 合理 论 ， 也 就 是 说 ， 组 合 某 种 类 型 (本 例 中 是 函数 ) 的 两 个 元 素 还 是 会 生成 一 个 该 类 型 的 新 元 素 。 组 合 函 


数 的 代码 非常 简单 ， 示 例如 下 : 


var compose = function(f,g) { 
return function(x) { 

return f(g(x)); 

村 

] 7 


上 述 代码 中 ，f 和 9 都 是 函数 ，x 是 在 它们 之 间 通 过 “管道 ”传输 的 值 。g 先 于 f 执 行 ， 因 此 数据 流 是 从 右 到 左 的 ， 这 一 点 符合 数学 上 的 
担心 执行 结果 出 现 意外 。 比 如 : 


合 ) ， 而 且 不 


“结合 律 ”的 概念 ， 能 为 编码 带 来 极 大 的 灵活 性 (可 以 任意 拆 分 和 组 


// 结合 律 (associativity) 


Var associative =compose (f, compose (g, h)) ==compose (compose (f, g), h); 


// true 


函数 式 编程 有 一 个 概念 称 为“ 隐 式 编程 ”， 也 称 为 “point-free 模 式 ”， 意 思 是 函数 不 


种 模式 。 首 先 ， 利 
递 。 


显然 ， 隐 式 编程 模式 隐 去 了 不 必要 的 参数 命 


可 以 直接 组 合 ; 


模式 ， 所 以 ， 应 当 根据 具体 情况 适当 选择 ， 不 能 使 


下 面 ， 再 来 看 一 个 例子 : 


// 非 隐 式 编程 ， 因 为 提 到 了 数据 : word 


， 让 代码 变 得 更 加 简洁 和 通 
因为 map 需 要 接受 两 个 参数 ， 自 然 不 能 


。 通 过 这 种 模式 ， 
接 组 合 ， 不 过 可 以 先 让 它 接受 一 个 函数 ， 


的 时 候 就 


普通 函数 。 


指明 操作 的 参数 (也 叫 points) ， 而 是 让 组 合 它 的 函数 来 处 理 参数 。 柯 里 化 及 组 合 协作 起 来 非常 有 助 于 实现 这 
柯 里 化 ， 让 每 个 函数 都 先 接 收 数据 ， 然 后 再 操作 数据 ; 接着 ， 通 过 组 合 将 数 拉 


届 从 第 一 个 函数 传递 到 下 一 个 函数 那里 去 。 这 样 ， 就 能 做 到 通过 管道 在 接受 单个 参数 的 函数 之 间 进 行 数 据 传 


很 容易 就 能 了 解 一 个 函数 是 否 为 接受 输入 返回 输出 的 小 函数 。 比 如 ，replace、split 等 都 是 这 样 的 小 函数 ， 
转化 为 一 个 参数 的 函数 ; 但 是 While 循环 无 论 如 何 是 不 能 组 合 的 。 另 外 ， 并 非 所 有 的 函数 式 代 码 都 是 这 种 


var snakeCase = function (word) { 
return word.toLowerCase() .replace (/\s+/ig, yy 


二 
// 隐 式 编程 


var snakeCase = compose (replace(/\s+/ig, '_'), toLowerCase); 


本 来 ，Javascript 的 错误 定位 就 不 准确 ， 这 样 的 组 合 也 会 给 debug 带 来 更 多 的 困难 。 幸 好 ， 我 们 可 以 使 用 下 面 这 个 实用 但 不 纯 的 trace 函 数 来 追踪 代码 的 执行 情况 。 


Var trace = curry (function (tag, x){ 
console.1log (tag, x); 
return x; 


DD); 
Var dasherize = compose (join('-'), toLower, split(' '), replace(/\s{2,}/ig, ' ')); 


dasherize('The world is a vampire'); 
// TypeError: Cannot read property 'apply' of undefined 


这 里 报错 了 ， 来 trace 下 : 


Var dasherize =compose (join('-'), toLower,trace ("after split"),split(' '),replace 
(/\s{2,}/ig,' ')); 
// after split [ 'The', 'world', 'is', 'a', 'vampire' ] 


原来 ，toLower 的 参数 是 一 个 数组 ( 记 住 ， 上 面 的 代码 是 从 右 向 左 执行 的 ) ， 所 以 需要 先 用 map 来 调用 一 下 它 : 


var dasherize =compose (join('-'),map (toLower), split (' '),replace(/\s{2,}/ig,' ')); 
dasherize('The world is a vampire'); 


// 'the-world-is-a-vampire' 


18.4.3 注释 : 签名 函数 的 行为 和 目的 


函数 式 编程 非常 灵活 ， 包 括 隐 式 编程 在 内 ， 参 数 均 被 大 大 减少 和 弱化 ， 这 点 为 我 们 阅读 和 使 用 函数 带 来 了 困扰 ， 对 协作 开发 也 是 一 项 挑战 ， 应 该 如 何 解决 呢 》 通常 的 做 法 就 是 添加 详细 的 文档 或 注释 ， 


不 过 函数 式 编程 有 其 自己 的 处 理 方式 ， 那 就 是 类 型 签名 。 类 型 签名 在 写 纯 函 数 时 所 起 的 作用 非常 大 ， 短 短 一 行 ， 就 能 暴露 函数 的 行为 和 目的 。 下 面 就 来 介绍 一 下 ， 函 数 式 编程 里 非常 著名 的 Hindley-Milner 


类 型 系统 。 这 个 名 称 是 两 位 科学 家 名 字 的 组 合 ， 常 被 简称 为 HM 类 型 系统 。 使 用 该 类 型 系统 的 时 候 ， 需 要 注意 以 下 几 个 要 点 。 


1) 函数 都 写成 a->b 的 样子 。 其 中 a 和 b 是 任意 类 型 的 变量 ， 这 人 句 话 的 意思 是 “一 个 接受 a， 返 回 b 的 函数 ”。 延 伸 一 下 ，a-> (b->c) 的 意思 就 是 “一 个 接受 a， 返 回 “一 个 接受 b 返 回 c 的 函数 ”的 函 


数 ”， 这 就 是 柯 里 化 了 。 


2) 把 最 后 一 个 类 型 视 作 返回 值 。 比 如 把 a-> (b->c) 简单 地 理解 成 a->b->c 也 没有 关系 ， 只 不 过 中 间 柯 里 化 的 过 程 被 忽略 了 而 已 。 


3) 参数 优先 级 是 从 左 向 右 ， 每 传递 一 个 参数 ， 就 会 得 到 后 面 对 应 部 分 的 类 型 签名 。 比 如 ，a-> (b->c) ， 传 入 了 参数 a， 得 到 的 自然 是 新 函数 ，b- > c。 


4) 可 以 在 类 型 签名 中 使 用 变量 。 把 变量 命名 为 3 和 b 只 是 一 种 约定 俗 成 的 习惯 ， 事 实 上 ， 可 以 使 用 自己 喜欢 的 任何 名 称 。 对 于 相同 的 变量 名 ， 其 类 型 也 一 定 要 相同 。 比 如 : a->b 可 以 是 从 任意 类 型 的 a 


到 任意 类 型 的 b， 但 是 a->a 则 必须 是 同一 个 类 型 。 例 如 ， 可 以 是 String->string， 也 可 以 是 Number->Number， 但 不 能 是 String->Bool。 同 时 ， 也 说 明 函 数 将 会 以 一 种 统一 的 行为 作 
b， 而 不 能 做 任何 特定 的 事情 ， 这 一 点 能 够 帮助 我 们 推断 函数 可 能 的 实现 。 


来 看 一 个 最 简单 的 例子 : 


于 所 有 的 类 型 a 或 


// capitalize :: String -> String 
Var capitalize = function(s){ 

return toUpperCase (head(s)) + toLowerCase (tail (s)); 
} 


capitalize ("smurf"); 
// =>"Smurf" 


这 里 ，capitalize 函 数 的 类 型 签名 就 是 “capitalize: : String->String” 这 行 注释 ， 可 以 理解 为 “一 个 接受 string 类 型 返回 String 类 型 的 函数 ”。 通 俗 点 说 ， 它 将 接受 一 个 String 类 型 作为 输入 ， 并 返回 


一 个 String 类 型 的 输出 。 


下 面 是 复杂 一 点 的 例子 : 


// match :: Regex -> String -> [String] 
// 可 以 理解 为 接受 一 个 'Regex' 和 一 个 'String'， 返回 一 个 ' [string]' 
Var match = curry (function (reg, s){ 

return s.match (reg); 


]) 


// match :: Regex -> (String -> [String]) 
// 可 以 理解 为 : 接受 一 个 'Regex' 作为 参数 ， 返 回 一 个 从 'String' 到 '[String]' 的 函数 
Var match = curry (function (reg, s){ 

return s.match (reg); 


1); 


// onHoliday :: String -> [String] 
// 可 以 理解 为 : 已 经 调用 了 'Regex' 参数 的 'match'。 给 了 第 一 个 参数 'Regex'， 返 回 的 结果 就 是 后 面 的 签名 内 容 
var onHoliday = match (/holiday/ig); 


下 面 来 体会 一 下 类 型 签名 的 好 处 : 


// head :: [al -> a 

compose (f, head) ==compose (head,map (f)); 

// filter :: (a -> Bool) -> [al -> [al 

compose (map (f) , filter (Compose (p, £))) 一 compose (filter (p) ,map(f) ) 7 


上 面 的 第 一 个 等 式 ， 左 边 : 先 获取 数组 的 头 部 ， 然 后 对 它 调用 函数 fi 右边: 先 对 数组 中 的 每 一 个 元 素 调用 f， 然 后 再 取 其 返回 结果 的 头 部 。 尽 管 没有 看 到 head、f 等 具体 代码 的 实现 ， 我 们 也 知道 这 两 个 


表达 式 的 作用 显然 是 相等 的 ， 但 是 前 者 要 快 得 多 ， 这 是 常识 。 这 就 为 函数 的 使 用 和 优化 提供 了 便利 ， 在 使 用 函数 的 时 候 ， 用 户 可 以 更 加 灵活 地 进行 选择 。 


18.4.4 容器 : 处 理 控制 流 、 异 常 、 异 步 和 状态 的 独立 模块 


从 代码 功能 的 角度 来 说， 类 型 是 最 小 的 单元 ， 类 似 于 原子 ; 函数 是 基本 单元 ， 类 似 于 由 原子 形成 的 各 类 细胞 ;容器 就 是 由 细胞 构成 的 人 体 组 织 。 在 一 个 程序 里 ， 容 器 就 像 是 一 个 功 介 


模块 ( 比 面向 对 象 


中 的 类 要 灵活 得 多 ) ， 有 自己 的 上 下 文 ， 包 含 了 特定 的 方法 (函数 ， 主 要 是 仿 函数 ) 和 属性 (状态) ， 能 够 独立 完成 某 些 方面 的 功能 或 事务 。 容 器 之 间 的 操作 和 通信 ， 需 要 用 到 特殊 的 数据 类 型 一 一 仿 函 数 


(functor) 。 


首先 ， 创 建 一 个 容器 : 


Var Container = function(x) { 
this. value = x; 


} 
Container.of = function(x) { return new Container (x); }; 


// (a -> b) -> Container a -> Container b 
Container.prototype.map = function (f){ 
return Container.of (f(this. value)) 


} 


将 其 命名 为 Container， 使 用 Container.of 作 为 构造 器 (constructor) ， 这 样 就 不 用 到 处 去 写 糟糕 的 New 关键 字 了 ， 非 常 省 心 。 这 个 容器 具备 一 切 容器 的 标准 特征 。 


1) 容器 有 且 只 有 一 个 属性 的 对 象 。 尽 管 容器 可 以 有 不 只 一 个 的 属性 ,但 大 多 数 容器 一 般 只 有 一 个 属性 。 可 以 很 随意 地 把 Container 的 这 个 属性 命名 为 _value， 当 然 也 可 以 命名 成 其 他 的 。 所 以 说 ， 容 器 
有 点 像 面向 对 象 的 类 ， 但 它 不 是 类 ， 因 为 我 们 不 会 为 它 添加 面向 对 象 观 念 下 的 属性 和 方法 。 


2) 容器 必须 能 够 装载 任意 类 型 的 值 。 因 此 ， 这 里 的 _value 不 能 是 某 个 特定 的 类 型 。 


3) of 方法 是 容器 的 入 口 访问 方法 。 这 是 一 种 简单 通用 地 人 往 仿 函 数 里 填 值 的 方式 。 数 据 一 旦 被 存放 到 容器 中 ， 就 会 一 直 待 在 那儿 。 我 们 可 以 用 .，value 获 取 到 数据 ， 但 是 尽量 不 要 这 么 做 。 


4) 仿 函 数 是 容器 的 出 口 访问 方法 。 操 作 和 使 用 数据 要 使 用 仿 函 数 ， 因 此 ， 在 具体 的 使 用 过 程 中 ， 仿 函数 基本 上 代表 了 容器 本 身 。 在 函数 式 编程 里 ， 到 处 都 有 仿 函 数 的 身影 ， 如 tree、list、map 和 pair 
等 可 友 代 数据 类 型 ， 以 及 eventstream 和 observable 等 。 


什么 是 仿 函 数 


在 网 上 搜索 一 下 ， 大 家 普遍 认为 仿 函数 这 个 概念 很 难 理解 。 说 实话 ， 从 字面 的 意思 上 来 看 ， 无 论 是 中 文 “ 函 子 ” “ 仿 函 数 ”， 还 是 英文 “functor”， 笔 者 一 开始 也 没 能 理解 它 到 底 是 什么 。 大 家 普遍 认 
可 的 是 Functor、Applicative 及 Monad 的 图 片 阐释 (http://jiyinyiyong.github.io/monads-in-pictures/) 里 的 解释 ， 图 文 并 茂 非常 清晰 ， 请 读者 自行 查阅 。 


对 这 种 舶 来 品 ， 笔 者 通常 的 做 法 是 直接 看 它 的 英文 解释 ( 见 18.6 节 中 给 出 的 维基 百科 上 的 functor 词 条 ) : “In mathematics，a functor is a type of mapping between categories, which is 
applied in category theory.” 翻译 过 来 就 是 : “在 数学 中 ， 仿 函数 应 用 于 范畴 学 ， 是 一 种 范畴 之 间 的 映射 。” 按 照 这 里 的 解释 把 它 称 为 Mappable 或 许 更 为 恰当 。 


接着 上 面 的 容器 话题 ， 一 旦 容器 里 有 了 值 ， 不 管 这 个 值 是 什么 ， 都 需要 一 种 方法 来 让 别 的 函数 能 够 操作 它 。 这 句 话 的 意思 是 ， 值 外 面 有 了 容器 ， 就 给 定 了 一 个 范畴 (上 下 文 ) ， 也 就 没有 办 法 像 前 面 那 
样 简单 地 操作 这 个 值 了 ， 怎 么 办 ? 这 时 仿 函 数 就 派 上 用 场 了 。 形 象 点 说 ， 就 是 容器 设 定 了 一 个 范畴 ， 仿 函数 为 它 搭 建 了 一 个 交流 通道 。 


上 面 代码 里 的 map 跟 数组 那个 著名 的 map 一 样 ， 除 了 前 者 的 参数 是 Container a 而 后 者 是 [a] 以 外 。 它 们 的 使 用 方式 几乎 也 是 一 致 的 : 


// 非特 殊 情 况 ， 使 用 Ramda]js 


var _ =require('ramda'); 


Container .of (2) .map (function (two) {return two +2}) 
// => Container (4) 


Container .of ("flamethrowers") .map (function(s) {returns .toUPPerCase () }) 
// => Container ("FLAMETHROWERS") 


Container.of ("bombs") .map (concat (' away')) .map(_.prop('length')) 
// => Container (10) 


of 方法 不 仅 可 以 用 来 避免 使 用 new 关 键 字 ， 而 且 还 可 以 用 来 把 值 放 到 默认 最 小 化 上 下 文 (default minimal context) 中 。of 其 实 就 是 pure、point、unit 和 return 之 类 的 函数 ， 它 是 一 个 名 为 pointed 仿 
函数 (实现 了 of 方法 的 仿 函 数 ) 重要 接口 的 一 部 分 。 这 里 的 关键 是 把 任意 值 丢 到 容器 里 ， 然 后 开始 到 处 使 用 map 的 能 力 。 


此 外 ， 可 以 在 不 离开 Container 的 情况 下 操作 容器 里 面 的 值 。Container 里 的 值 传递 给 map 函 数 之 后 ， 就 可 以 自由 操作 了 ; 操作 结束 之 后 ， 为 了 防止 意外 再 把 它 放 回 它 所属 的 Container 中 。 这 样 做 的 结 
果 是 ， 可 以 连续 地 调用 map， 运 行 任何 想 要 运行 的 函数 ， 甚 至 还 可 以 改变 值 的 类 型 。 


让 容器 自己 运用 函数 ， 有 利于 对 函数 运用 进行 抽象 。 当 map 一 个 函数 的 时 候 ， 我 们 请 求 容器 来 运行 这 个 | 
函数 在 调用 的 时 候 ， 如 果 被 map 包 里 了 ， 那 么 它 就 会 从 一 个 非 仿 函 数 转换 为 一 个 仿 函 数 。 一 般 情况 下 ， 普 通 
函数 去 操作 容器 类 型 即 可 ， 这 样 做 的 好 处 是 随 需求 而 变 ， 能 更 方便 地 得 到 更 简单 、 重 用 性 更 高 的 函数 。 


数 ， 这 是 一 种 十 分 强大 的 理念 。 这 种 让 容器 运行 函数 的 方法 就 是 “ 仿 函 数 ”。 通 俗 点 进 ， 一 个 
数 更 适合 操作 普通 的 数据 类 型 而 不 是 容器 类 型 ， 其 只 在 必要 的 时 候 再 通过 map 转 变 为 合适 的 仿 


函 
函 


因为 仿 函 数 的 概念 来 自 于 范畴 学 ， 因 此 它 应 该 满足 一 些 定律 ， 学 习 和 理解 这 些 实用 的 定律 ， 会 帮助 我 们 更 好 地 使 用 它 。 如 下 是 两 个 重要 的 定律 : 


// 同一 性 identity 
map (id) === id; 


// 结合 律 composition 
Compose (map (f) ,map (g)) ===map (Compose (£f, 9g)); 


下 面 根据 不 同 的 功能 介绍 几 种 重要 的 仿 函 数 。 


18.4.5 “数据 验证 仿 函 数 


上 面 所 讲 的 Container 功 能 单一 ， 下 面 就 来 对 它 进行 一 系列 的 重 构 ， 以 满足 不 同 的 需要 。 请 注意 ， 每 次 重 构 所 得 到 的 新 容器 ， 都 是 一 种 具备 特定 功能 的 仿 函数 。 先 给 数据 加 上 验证 看 看 ， 毕 况 数 据 是 否 
为 空 ， 是 编程 无 法 绕 开 的 罗 辑 之 一 ， 对 于 具备 这 种 特性 的 仿 函 数 ， 函 数 式 编程 中 将 其 称 为 Maybe。 更 多 内 容 ， 请 参考 学 习 folktale s 
data.maybe (https://github.com/folktale/data.maybe/blob/master/lib/maybe.js) 。 


Var Maybe = function (X) { 
this. value = x; 


} 


Maybe.of = function(x) { 
return new Maybe (x); 


} 


Maybe.prototype.isNothing = function() { 
return (this. value 一 =- null || this._ value 一 =- undefined); 


i 


Maybe.prototype.map = function(f) { 


return this.isNothing() ? Maybe.of (null) : Maybe.of (f(this. value)); 
} 


Maybe.of (nul1) .map (match (/a/ig)) 
// => Maybe (nul1) 


Maybe.of ({name: "Boris"}) .map(_.prop("age")) .map (add(10) ) 7 
// => Maybe (nul1) 


看 似 很 小 的 改进 ， 却 让 代码 变 得 更 加 健壮 。 除 了 能 时 刻 检查 参数 的 存在 性 ， 还 
果 。 


Maybe (null) 来 发 送 失败 的 信号 ， 让 程序 在 接 到 这 个 信号 时 立刻 切断 后 续 代码 的 执行 ， 这 通常 是 编码 希望 达到 的 效 


和 
SG 


18.4.6 ”错误 处 理 仿 函 数 


对 于 错误 处 理 ， 当 我 们 不 知道 到 底 是 什么 错误 时 ， 用 得 比较 多 的 是 throw/catch， 但 是 这 样 做 会 影响 性 能 ， 错 误 信 息 也 不 怎么 友好 ， 而 且 还 可 能 会 打破 “ 纯 ”函数 ， 让 其 变 得 不 再 “ 纯 ”。 当 然 ， 也 可 
以 使 用 if 语句 来 判定 ， 给 出 具体 的 错误 信息 。 在 函数 式 编程 里 ， 通 常 使 用 Either 这 个 仿 函 数 。 字 面 含 义 为 “或 者 ”的 意思 ， 属 于 二 选 一 的 两 个 分 支 。 更 多 内 容 请 参考 学 习 folktale's 
data.either (https://github.com/folktale/data.either/blob/master/lib/either.js) 。 


下 面 就 列 出 其 部 分 代码 ， 具 体 如 下 : 


Var Left = function(x) { 
this. value = x; 


bE 


Left.of = function(x) { 
return new Left (x); 


} 


Left .prototype.map = function(f) { 
return this; 


} 


var Right = function(x) { 
this. value = x; 


} 


Right.of = function(x) { 
return new Right (x); 


} 


Right .prototype.map = function(f) { 
return Right.of (f(this. value)); 
} 


这 里 略 去 了 创建 Either 父 类 的 代码 ， 只 给 出 了 它 的 两 个 子 类 Left (代表 错误 ) 和 Right (代表 正确 ) ， 就 来 看 看 它们 是 怎么 运行 的 : 


Right.of("rain") .map (function (str) {return"b"+str; }); 
// Right ("brain") 


Left .of ("rain") .map (function (str) {return"b"+str;}); 
// Left ("rain") 


Right.of({host:'localhost',port:80}) .map(_.prop('host"')); 
// Right('localhost') 


Left .of ("rolls eyeshttp://www.hzcourse.com/resource/readBook?path=/openresources/teach « hoo/ oo eesed/ oa/ Oa Es Tosh | .map (_.Prop ("host")); 
// Left('rolls eyeshttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/. 


Left 无 视 map 的 请 求 。Right 的 作用 就 是 一 个 最 基础 的 Container。 这 里 强大 的 地 方 在 于 ，Left 有 能 力 在 它 内 部 嵌入 一 个 错误 消息 。 


前 面 说 了 ， 可 以 用 Maybe (null) 来 表示 失败 并 把 程序 引 向 另 一 个 分 支 ， 但 是 它 不 会 提供 太 多 的 信息 ， 有 时 候 我 们 想 要 知道 失败 的 原因 是 什么 。 比 如 : 


Var moment = require('moment'); 


// getAge :: Date -> User -> Stan Number) 
Var getAge = .curry (function (now, user) 
// moment v2.3.0 以 后 的 版 本 要 添加 true 参 数 ， 《表示 使 用 严格 模式 ， 参考 ; http:// momentjs.com/docs/#/parsing 
Var birthdate = moment (user.birthdate, 'YYYY-MM-DD', true); 
if(!birthdate.isValid()) return Left.of("Birth date could not be parsed"); 
return Right.of (now.diff (birthdate, 'years')); 
Ds 


getAge (moment (), {birthdate: '2005-12-12'}); 
// Right (9) 


getAge (moment (), {birthdate: '20010704'}); 
// Left ("Birth date could not be parsed") 


这 么 一 来 ， 就 像 Maybe (null) 一 样 ， 当 返回 一 个 Left 的 时 候 就 让 程序 直接 终止 。 与 Maybe (null) 不 同 的 是 ， 现 在 我 们 对 程序 为 何 终止 有 了 更 多 的 信息 。 下 面 再 来 进一步 看 看 ， 应 该 怎么 


// fortune :: Number -> String 
Var fortune = .compose(_.concat ("If you survive, you will be "), .add(1)); 


// zoltar :: User -> Either(String, ) 

// 在 类 型 签名 中 使 用 '_'， 表 示 一 个 应 该 忽略 的 值 ; 

// 通常 ， 不 会 把 'console.1og' 放 到 'zoltar' 函数 里 ， 而 是 在 调用 'zoltar' 的 时 候 才 'map' 它 
Var zoltar =_.compose (_.map (console.1og)，_ .map (fortune) ,getRge (moment () ) ) 7 


zoltar ({birthdate: '2005-12-12°'}); 
// "If you survive, you will be 11" 
// Right (undefined) 


zoltar ({birthdate: 'balloons!'}); 
// Left ("Birth date could not be parsed") 


进一步 优化 ， 添 加 一 个 either 方法 ， 让 它 接受 两 个 函数 (分 别 对 应 Left 和 Right 的 情况 ) 和 一 个 静态 值 为 参数 : 


// either :: (a -> c) -> (b -> c) -> Either ab ->c 
Var either = .curry(function(f, g, e) 1{ 
Switch (e.constructor) { 
case Left: return fle._ value); 
case Right: return gl(le. value); 
} 
]) 


// zoltar :: User -> _ 
Var zoltar = _.compose (console.log, either( .identity, fortune), getAge (moment () ) ) 7 


zoltar ({birthdate: '2005-12-12'}); 
// "If you survive, you will be 10" 
// undefined 


Zoltar ({birthdate: 'balloons!'}); 
// "Birth date could not be parsed" 


// undefined 


Either 并 不 仅仅 是 对 合法 性 检查 发 现 的 一 些 错误 有 用 ， 对 一 些 更 严重 的 、 能 够 中 断 程序 执行 的 错误 ， 比 如 文件 丢失 或 Socket 连 接 断 开 等 ， 同 样 有 显著 的 效果 。 另 外 ， 这 里 仪 把 Either 当 作 一 个 错误 消息 
的 容器 ， 其 实 它 还 能 做 更 多 的 事情 。 


18.4.7 ”异步 处 理 仿 函 数 


在 JavaScript 的 世界 里 ， 回 调 (callback) 是 无 法 回避 的 。 幸 好 ， 对 于 异步 代码 的 处 理 ， 函 数 式 编程 有 一 种 更 好 的 方式 。 这 种 方式 的 内 部 机 制 比较 复杂 ， 所 以 还 是 通过 使 有 
Folktale (http://folktalejs.org/) 里 的 Data.Task， 来 从 实例 中 体会 吧 : 


// 这 是 Folktale 官 方 的 例子 
Var Task = require('data.task') 
Var fs = require('fs') 


// read : String -> Task(Error, Buffer) 
function read(path) { 
return new Task (function (reject, resolve) { 
fs.readFile (path, function(error, data) { 
if (error) reject (error) 
else resolve (data) 
1 
}) 
} 


// decode : Task(Error, Buffer) -> Task (Error, String) 
function decode (buffer) { 
return buffer.map (function (a) { 
return a.toSstring('utf-8') 
}) 
} 


var one = decode (read('one.txt')) 
Var two = decode (read('two.txt')) 


// 使 用 ' .chain， 来 关联 两 个 异步 行为 ， 使 用 ' .map' 同步 运算 任务 的 最 终 值 
Var concatenated = one.chain(function(a) { 
return two.map (function(b) { 
returna+b 
}) 
}) 


// 必须 使 用 ' .fork， 来 明确 执行 ， 如 果 错 误 则 使 用 第 一 个 函数 抛 出 ， 如 果 成 功 则 调用 第 二 个 函数 
concatenated. fork( 

function(error) { throw error }, 

function(data) { console.log(data) } 
) 


例子 中 的 reject 和 和 resolve 函 数 分 别 是 失败 和 成 功 的 回调 。 可 以 用 chain 来 运行 两 个 异步 行为 ， 简 单 地 调用 Task 的 map 函 数 ， 就 能 操作 异步 执行 之 后 的 值 ， 好 像 这 个 值 就 在 那儿 似 的 ; 调用 fork 方 法 才能 
运行 Task， 它 会 fork 一 个 子 进程 运行 它 所 接收 到 的 参数 代码 ， 其 他 部 分 的 执行 则 不 受 影响 ， 主 线程 也 不 会 阻塞 。 


这 里 的 控制 流 是 线性 的 。 只 需要 从 下 读 到 上 ， 从 右 读 到 左 就 能 理解 代码 ， 即 便 这 段 程序 实际 上 会 在 执行 过 程 中 跳 来 跳 去 。 相 比 于 那 种 要 在 各 种 回调 和 错误 处 理 代 码 块 之 间 跳 跃 的 方式 ， 这 种 方式 使 得 阅 
读 和 理解 应 用 程序 的 代码 容易 得 多 。 


18.4.8 ” 底 套 处 理 仿 函 数 


这 个 世界 是 复杂 的 ， 我 们 把 普通 函数 放 进 了 容器 ， 弄 出 了 这 么 多 仿 函 数 。 那 么 ， 如 果 把 容器 放 进 相同 的 容器 里 ， 一 层 层 府 套 起 来 (就 像 层 层 包 囊 的 洋葱 monad) ， 又 该 怎么 办 呢 ? 最 直接 的 处 理 方式 就 


是 多 用 几 次 map。 不 过 ， 关 于 这 类 情况 也 有 专门 的 处 理 方式 。 


1. 同 类 型 容器 的 嵌 套 调 monad 


如 果 有 两 层 相 同类 型 容器 的 谋 套 ， 那 么 就 可 以 用 join 把 它们 压 扁 到 一 块 去 。 这 种 结合 的 能 力 ， 仿 函数 之 间 的 关联 ， 就 是 monad 之 所 以 成 为 monad 的 原因 。 下 面 来 看 看 它 更 精确 的 完整 定义 : 


monad 是 可 以 变 扁 (flatten) 的 pointed 仿 函数 。 


一 个 仿 函 数 ， 只 要 它 定义 了 一 介 oin 方 法 和 一 个 of 方法 ， 并 遵守 一 些 定律 ， 那 么 它 就 是 一 个 同类 型 由 套 仿 函 数 (这 是 笔者 个 人 杜撰 的 名 称 ， 真 正 的 函数 式 编程 高 手 会 不 喜欢 这 个 称谓 ， 大 家 习惯 的 还 是 
monad) 。join 的 实现 并 不 复杂 ， 下 面 来 为 Maybe 定 义 一 个 : 


Maybe.prototype.join = function() { 
returnthis.isNothing() ? Maybe.of (null) : this. value; 
} 


如 果 有 一 个 Maybe (Maybe (x) ) ， 那 么 .value 将 会 移 除 多 余 的 一 层 ， 然 后 就 能 安心 地 从 那里 开始 进行 map 了 。 要 不 然 ， 将 会 只 有 一 个 Maybe， 因 为 从 一 开始 就 没有 任何 东西 会 被 map 调 


很 多 情况 下 ，join 总 是 紧 跟 在 map 的 后 面 被 调用 。 这 时 候 ， 可 以 把 这 个 行为 进一步 抽象 到 一 个 名 为 chain 的 函数 里 : 


// chain :: Monad m => (a ->mb) ->ma->mb 
Var chain = curry(function(f, m){ 
return m.map (f) .join(); // 或 者 compose (join，map (f) ) (m) 


DD); 


这 里 仅仅 是 把 mapyjoin 打 包 到 一 个 单独 的 函数 中 。 在 一 些 库 里 ，chain 也 称 为 >> = ( 读 作 bind) 或 flatMap， 都 是 同一 个 概念 的 不 同名 称 罢 了 。flatMap 是 最 简单 明了 的 ， 但 chain 是 Javascript 里 接受 
程度 最 高 的 一 个 。 虽 然 是 简单 地 处 理 了 一 下 ， 但 是 该 方法 的 用 途 却 被 无 限 扩展 ， 上 面 的 “Task” 例 子 中 用 到 的 就 是 它 ， 请 大 家 访问 它 的 源码 自行 研究 。 


2. 不 同类 型 容器 的 调用 一 一 applicative 


同类 型 容器 黎 套 可 使 用 monad 仿 函数 的 处 理 方式 ， 但 这 种 方式 有 一 个 问题 ， 那 就 是 顺序 执行 的 问题 : 所 有 的 代码 都 只 会 在 前 一 个 函数 执行 完毕 之 后 才 执行 。 其 实 ， 在 很 多 情况 下 ， 这 是 没有 必要 的 。 其 
更 好 的 替代 方法 就 是 使 用 applicative 仿 函数 。applicative 仿 函数 是 实现 了 ap 方法 的 pointed 仿 函数 。ap 方 法 类 似 于 下 面 这 样 : 


Container.prototype.ap = function (other_container) { 
return other_container.map (this. value); 


} 


this，value 是 一 个 函数 ， 将 会 接收 另 一 个 functor 作 为 参数 ， 所 以 这 里 只 需 map 它 即 可 。 这 里 隐 含 的 定律 是 : 


了 .of (x) .map (f) ==F.of (f) .ap (F.of (x)) 


map 一 个 {等 价 于 ap 一 个 值 为 f 的 functor。 更 简单 的 理解 就 是 : map 等 价 于 of/ap。 


那么 ， 下 面 可 以 利用 这 点 来 定义 map: 


// 从 of/ap 衍生 出 的 map 
X.prototype.map = function(f) { 
return this.constructor.of (f) . 


} 


ap(this); 


如 果 已 经 有 了 一 个 chain 函 数 ， 那 么 也 可 以 借助 monad 轻 松 得 到 仿 函 数 (含有 map 方 法 的 ) 和 applicative (含有 ap 方法 的 ) : 


// 从 chain 中 衍生 出 的 map 
X.prototype.map = function(f) { 
Var m= this; 
return m.chain(function(a) { 
return m.constructor.of (f(a)); 
I 
} 


// 从 chain/map 中 衍生 出 的 ap 
X.prototype.ap = function (other) { 
return this.chain (function(f) { 

return other.map (f); 
4 
}; 


这 一 点 非常 强大 ， 甚 至 可 以 审查 一 个 数据 类 型 ， 然 后 自动 化 这 个 过 程 。 处 理 多 个 仿 函 数 作为 参数 的 情况 ， 是 applicative functor 一 个 非常 好 的 应 用 场景 。 借 助 applicative 能 够 在 仿 函 数 的 世界 里 调用 函 
合 


数 。 尽 管 已 经 可 以 通过 monad 达 到 这 个 目的 (向 下 的 嵌 套 结构 使 得 monad 拥 有 串 行 计 
适 的 方法 来 解决 合适 的 问题 。 


算 、 变 量 赋 值 和 暂缓 后 续 执行 等 独特 的 能 力 ) ， 但 在 不 需要 monad 特 定 功 能 的 时 候 最 好 使 用 applicative， 这 就 是 上 


下 面 列举 一 个 最 常见 的 例子 ， 假 设 要 创建 一 个 旅游 网 站 ， 既 需要 获取 游客 目的 地 的 列表 ， 还 需要 获取 地 方 事件 的 列表 。 这 两 个 请 求 之 间 只 需要 通过 相互 独立 的 API 调 用 即 可 ， 代 码 如 下 : 


// Http.get :: String -> Task Error HTML 
Var renderPage = curry (function (destinations, events) { /* render page * 


Task.of (renderPage) .ap (Http.get ('/destinations')) .ap(Http.get ('/events') 
// Task("<div>some page with dest and events</div>") 


.Hs 
» 


两 个 请 求 将 会 同时 立即 执行 ， 当 两 者 的 响应 都 被 返回 之 后 ，renderPage 就 会 被 调 有 


。 这 与 monad 版 本 的 那 种 必须 等 待 前 一 个 任务 完成 之 后 才能 继续 执行 后 面 的 操作 完全 不 同 。 本 来 就 无 须根 据 目的 地 


来 获取 事件 ， 因 此 也 就 不 需要 依赖 顺序 执行 了 。 由 此 可 以 看 出 ，applicative 处 理 异 步 和 并 发 是 多 么 简单 的 事情 。 还 有 更 多 更 好 的 实例 ， 请 参阅 相关 文档 。 


18.5 总 结 


本 章 作为 函数 式 编程 的 入 门 章节 ， 主 要 面向 初学 者 以 及 习惯 了 面向 对 象 编程 的 程序 员 。 本 章 从 思维 和 实践 的 角度 研究 了 函数 式 编程 的 方法 ， 并 针对 编码 中 的 常见 问题 列举 了 对 应 的 基本 解决 思路 ， 还 将 


一 些 概念 与 其 他 编码 方法 做 了 类 比 ， 可 能 并 不 是 很 贴切 ， 请 在 阅读 时 注意 区 分 辨别 。 


为 本 章 重 在 思维 逻辑 ， 所 以 并 没有 罗列 函数 式 编程 的 过 多 内 容 和 方式 方法 ， 对 提 到 的 内 容 也 没有 进一步 地 深入 探讨 。 


18.6 节 列举 了 一 些 优秀 的 参考 文档 ， 售 有 大 量 的 分 析 和 解读， 请 读者 自行 查阅 。 


目前 ,开源 社区 提供 了 很 多 优秀 的 函数 式 编程 库 ， 比 如 : lodash/FP、ramda.js、 


Folktale 等 ,文章 “JavaScript 的 函数 式 库 ”还 列举 了 其 他 一 些 优秀 的 库 ， 并 进行 了 深入 分 析 和 介绍 。 这 些 库 ， 既 可 以 


在 生产 中 参考 使 用 ， 更 可 以 作为 学 习 研 究 的 范本 ， 是 值得 学 习 和 参考 的 。 亿 书 将 在 后 续 的 版 本 和 产品 中 认真 学 习 和 实践 这 些 优秀 的 编程 方法 ， 进 一 步 减 少 核心 库 的 代码 量 ， 提 高 主 链 和 侧 链 的 综合 性 能 。 
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第 19 章 ”轻松 从 JavaScript 文 件 生成 UML 类 图 


第 18 章 讲解 了 很 多 内 容 ， 其 中 一 些 内 容 可 能 会 让 读者 感觉 比较 费解 。 本 章 将 通过 一 个 具体 实例 ， 让 大 家 切身 感受 一 下 函数 式 编程 的 奥妙 和 趣味 。 当 然 ， 仅 仅 为 了 举例 而 编写 代码 是 没有 什么 意义 的 ， 本 


书 中 所 提供 的 例子 都 是 在 具体 的 项 目 或 应 用 中 承担 了 某 项 任务 的 ， 本 章 自然 也 不 例外 。 


本 书 用 到 了 大 量 的 UML 类 图 ， 经 常会 有 读者 问 笔者 UML 类 图 是 用 什么 工具 画 的 。 其 实 ， 最初 的 几 个 是 笔者 手工 一 点 一 点 整理 而 成 的 ， 但 后 来 感觉 那样 做 效率 太 低 且 时 间 浪 费 比 较 严 重 ， 所 以 就 开发 了 


js2uml ( 见 19.6 节 中 给 出 的 链接 ) 这 个 小 工具 。 只 不 过 ， 当 初 开发 这 个 工具 的 目的 很 单一 ， 


法 树 ， 顺 带 使 用 函数 式 编程 进行 了 重 构 ， 因 此 该 工具 变 得 更 加 通用 了 。 


19.1 工具 简要 介绍 


网 


这 是 一 个 命令 行 工 具 ， 可 以 轻松 地 从 JavaScript 文 件 中 生成 UML 类 图 ， 如 


这 里 主要 实现 了 以 下 两 个 功能 


1) 直接 读 取 JavaScript 源 码 ， 产 生 plantuml (http://plantuml.com/) 能 够 认识 的 格式 文件 。 笔 者 个 人 比较 喜欢 用 .pu 作为 后 缀 。 


19-1 所 示 。 


仅仅 是 使 用 正则 表达 式 过 滤 JavaScript 代 码 ， 所 以 不 够 灵活 ， 自 然 也 没有 单独 放出 来 。 不 过 ， 现 在 引入 了 抽象 语 


为 代码 量 很 少 ， 并 且 第 18 章 中 已 经 对 函数 式 编程 进行 了 大 量 的 阐述 ， 所 以 本 章 就 不 再 详细 描述 其 编码 过 程 了 ， 仅 仅 提 供 该 工具 的 设计 思路 和 流程 ， 感 兴趣 的 读者 请 自行 查阅 源 代码 。 


生成 图 19-1 的 代码 及 格式 如 下 : 


© create: (data,trs) 

© calculateFee: (trs,sender) 
© verify: (trs,sender,cb) 

® process: (trs,sender,cb) 
© getBytes: (trs) 


© apply (trs,blocksender,cb) 

© undo: (trs,block.sender,cb) 

© applyUnconfirmed: (trs,sender,cb) 
© undoUnconfirmed (trs,sender,cb) 
® objectNormalize: (trs) 

© dbRead: (raw) 

© dbSave: (trs,cb) 

© ready; (trs,sender) 


© create': (data,trs) © create: (data,trs) 

® calculateFee: (trs,sender) © calculateFee: (trs,sender) 

® verify (trs,sender,cb) © verify: (trs,sender,cb) 

® process: (trs,sender,cb) ® process: (trs,sender,cb) 

© getBytes: (trs) © getBytes: (trs) 

® apply (trs,block,sender,cb) ® apply: (trs,blocksender,cb) 

® undo: (trsblocksendercb) © undo: (trs,block,sender,cb) 
© applyUnconfirmed: (trs,sender,cb) 
© undoUnconfirmed: (trs,sender,cb) 

® objectNormalize: (trs) ® objectNormalize: (trs) 

® dbRead: (raw) © dbRead (raw) 

® dbSave: (trs,cb) © dbSave' (trs,cb) 

© ready: (trs,sender) © ready: (trs,sender) 


m attachApi: 0 
mn get (idcb) 


m getBylds: (ids,cb) 


mn list: (filter,cb) 


m createBasePathes: (cb) 


m installDependencies: (dApp,cb) 


m getinstalledlds: (cb) 


© InTransfer m removeDApp: 


(dApp,ch) 


m downloadDApp: (dApp,cb) 


m getFile: (dapp, 


m symlink: (dApp,cb) 
m apiHandler (message,callback) 


res) 


m geticon: (dapp,res) 

m dappRoutes: (dapp,cb) 
a launch: (body,ch) 

@ downloadSiaFile: (id,ascii,icon, path,cb) 
m launchApp: (dApp,params,cb) 
m stop: (dApp,cb) 

m addTransactions: (req,cb) 

© sandboxApi: (call,args,cb) 

© message: (dappid,body,cb) 


© onBlockchainReady: 0 


® onDeleteBlocksBefore: (block) 


® onNewBlock (block broadcast) 
© getGenesis: (req,cb) 
© setReady: (req,cb) 


© getCommonBl 


lock (reqcb) 


©® sendWithdrawal: (req,cb) 


© getWithdrawalLastTransaction: (req,cb) 
© getBalanceTransactions: (req,cb) 


copyright (c) imfly 2016 年 9 月 1 日 下 午 12 点 35 分 ,，http://bitcoin-on-nodejs.ebookchain.org 


图 19-1 使 用 js2uml 生 成 的 类 图 样式 


卓 
1 


Q@startuml 
title 类 图 标题 


footer copyright (c) imfly 2017 年 9 月 1 日 下 午 12 点 35 分 http:// bitcoin-on-nodejs.ebookchain.org 


header 《Node.js 区 块 链 开 发 》 分 析 用 图 : 《区 块 链 》 


Class Loagder { 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


$ 


' relationship 
Dapp --> dbLite 
Qenduml 


然后 ， 使 用 Graphviz 工 具 (http://www.graphviz.org/) 就 可 以 导出 PNG 等 格式 的 
时 候 还 需要 通过 手工 做 进一步 修改 。 另 外 ， 这 也 为 以 后 与 其 他 工具 集成 提供 了 便利 。 


2) 直接 生成 PNG、SVG 等 格式 的 图 片 文件 。 这 是 对 Graphviz 的 直接 扩展 。 


具体 安装 和 使 用 方法 非常 简单 ， 请 直接 查看 文档 ， 这 里 不 再 歼 述 。 


19.2 能 从 中 学 点 什么 


通过 这 个 小 工具 的 开发 ， 读 者 可 以 学 习 以 下 几 项 技能 。 


“ 抽象 语法 树 (Abstract Syntax Tree，AST) 的 处 理 。 抽 象 语法 树 有 多 种 用 途 ， 大 部 分 人 可 能 很 少 


[ 


片 了 。 之 所 以 提供 导出 这 类 格式 的 文件 ,3 


EF 要 是 工具 


对 于 排版 的 处 理 还 不 够 智能 ， 布 局 、 关 联 关系 、 背 景 图 片 等 有 


能 。 使 用 Node.js 的 小 伙伴 ， 最 后 都 要 对 代码 进行 混淆 、 压 缩 等 处 理 ， 那 些 工 具 也 几乎 都 要 用 到 。 


会 直接 在 代码 里 使 用 抽象 语法 树 ， 但 是 几乎 每 个 人 都 在 用 ， 比 如 : 编辑 器 的 自动 提示 、 自 动 完 成 等 功 


. 还 数 式 编程 。 原来 的 版 本 是 完全 面向 对 象 的 编程 方式 ， 也 没有 使 用 AST， 所 以 代码 很 长 ， 功 能 也 有 限 。 这 个 版 本 进行 了 优化 ， 使 用 函数 式 编程 的 方式 ， 不 仅 大 大 缩减 了 代码 量 ， 还 提供 了 直接 导 
出 .png、.svg、.pu 等 各 种 格式 图 片 的 功能 。 


:学习 plantuml。 这 是 使 用 代码 处 理 UML 的 最 好 方式 ， 直 接 使 用 dot 语 言 (生成 的 .pu 文件 就 是 ) ， 像 编写 程序 一 样 画 UML 图 ， 真 的 是 只 有 程序 员 才能 体会 的 畅快 。 


.命令 行 工具 开发。 


19.3 ”关于 抽象 语法 树 


在 没有 任何 运行 环境 的 情况 下 ， 要 想 对 源码 进行 分 析 ， 通 常 有 两 种 方法 可 供 选择 : 一 种 方法 就 是 使 用 正则 表达 式 ， 正 如 第 一 版 本 里 用 到 的 那样 ， 但 是 正则 表达 式 只 能 从 源码 中 抽取 有 限 的 格式 ， 且 很 容 
易 固定 格式 ， 特 别 是 对 JavaScript 这 种 没有 真正 的 类 概念 的 脚本 语言 来 说 ， 就 更 不 通用 了 。 另 一 种 方法 是 抽象 语法 树 ， 它 是 程序 的 一 种 中 间 表 示 形 式 ， 是 专门 用 于 程序 分 析 的 。 凡 是 涉及 对 源 程序 进行 操作 
和 处 理 的 应 用 ， 都 会 用 到 抽象 语法 树 ， 比 如 大 家 经 常 使 用 的 智能 编辑 器 、 语 言 翻译 器 等 。 因 此 ， 更 好 的 也 是 最 通用 的 方法 就 是 使 用 抽象 语法 树 。 


抽象 语法 树 具有 不 依赖 于 具体 编程 语言 文法 和 语言 细节 的 特点 ， 所 以 对 于 不 同 的 编码 方式 ， 甚 至 不 同 的 编程 语言 ， 在 进行 语法 分 析 的 时 候 ， 都 能 构造 出 相同 的 语法 树 ， 这 就 为 后 端 实现 了 清晰 、 统 一 的 
接口 。 这 对 于 把 控 代 码 质量 ， 控 制 编 码 行为 ， 甚 至 在 必要 的 时 候 进行 批量 重 构 ， 提 供 了 切实 可 行 的 操作 方法 。 我 们 之 所 以 要 研究 和 使 用 这 项 技术 ， 一 个 根本 的 目的 就 是 为 了 开发 一 个 与 亿 书 项 目 配套 的 辅助 
项 目 一 一 亿 书 的 远程 开源 协作 开发 平台 。 


该 平台 能 够 监控 每 一 个 贡献 者 的 代码 数量 和 质量 ， 并 给 出 优化 建议 ， 对 贡献 者 每 次 提交 的 代码 贡献 ， 可 通过 亿 书 智 能 合约 自动 支付 合理 的 亿 书 币 报酬 ， 最 后 写 入 区 块 链 。 这 个 平台 将 改变 程序 员 的 生活 
方式 ， 让 按照 代码 贡献 计酬 的 方式 变 得 更 加 科学 ， 加 之 区 块 链 智能 合约 的 底层 支持 ， 程 序 员 无 论 身 处 何 处 ， 都 可 以 随时 贡献 自己 的 智慧 ， 并 获得 收益 ， 这 也 让 远程 办 公 成 为 非常 简单 和 现实 的 事情 。 


前 文中 也 说 了 ， 对 JavaScript 代 码 的 混淆 和 压缩 都 用 到 了 抽象 语法 树 。 著 名 的 混淆 和 压缩 工具 UglifyJs (https://github.com/mishoo/UglifyJS) 最 早 是 他 们 自己 开发 的 解析 工具 ， 但 是 最 新 版 本 的 
UglifyJSs2 (https://github.com/mishoo/UglifyJS2) 使 用 acorn 进 行 了 重 写 。 在 Node.js 的 世界 里 ， 有 几 个 比较 优秀 的 抽象 语法 树 处 理 包 ， 除 了 acorn， 还 有 一 个 Esprima。 这 里 使 用 的 是 Esprima。 


19.4 ”工具 实现 过 程 


19.4.1 基本 需 3 


这 个 工具 的 需求 非常 简单 ， 就 是 给 定 一 个 JavaScript 源 码 文件 ， 直 接 导出 分 析 后 的 UML 文 件 或 图 片 。 这 类 简单 的 应 用 模型 ， 其 应 用 非常 普遍 ， 甚 至 可 以 说 任何 大 的 应 用 项 目 ， 都 是 由 这 类 简单 的 应 用 模 
型 以 搭 积木 的 方式 搭建 起 来 的 。 本 书 的 第 二 部 分 “Nodejs 入 门 指南 。 中 曾经 提 到 过 ， 若 要 使 用 Node.js， 那 么 最 好 先 习 惯 数据 “ 流 ” 的 概念 ， 这 里 从 JavaScript 文 件 到 UML 或 图 片 文件 的 过 程 ， 就 是 典型 的 
数据 “ 流 ” 的 实现 。 我 们 要 做 的 ， 仅 仅 是 在 这 个 “ 流 ” 上 制造 一 些 “ 过 滤器 ”而 已 。 


第 18 章 中 提 到 过 函数 式 编程 更 适合 处 理 数据 “ 流 ”， 该 方式 的 一 个 重点 就 是 告诉 程序 “是 什么 ” (声明 式 ) ， 而 不 是 “怎么 干 ” (命令 式 ) 。 换 句 话说， 只 要 好 好 描述 这 里 的 “过 滤器 ”是 什么 就 行 
了 ,和 干 万 不 要 关心 它们 是 怎么 干 的。 比如 在 开发 的 过 程 中 ， 为 了 调试 方便 ， 笔 者 一 般 是 这 样 搭 积木 的 (命令 式 ) : 


// 文件 ./1ib/index.js 

// 26 行 

function(data) { 
var functionList = parser (data); 
Var formatData = format (functionList); 
Var result = template (formatData); 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


这 段 代 码 一 看 就 可 以 写成 这 样 : 


Var result = template (format (parser (data))); 


所 以 ， 这 段 代 码 在 函数 式 编程 里 就 是 (这 里 使 用 ramda 来 处 理 函 数 式 编程 ) : 


xz 直行 
var getPuml = _.compose (template，format，Parser); // 声明 式 


// 28 行 
Var puml = getPuml (data); 


沿 着 这 个 思路 逐个 进行 拆 分 和 组 合 ， 就 能 非常 清晰 地 处 理 整个 过 程 。 


19.4.2 ”架构 流程 和 代码 结构 


还 是 用 一 张 图 来 说 明 架 构 的 流程 和 代码 的 结构 吧 ， 如 图 19-2 所 示 ， 非 常 简单 。 


整个 程序 入 口 是 `lib/index.js” ， 
仅仅 是 提供 一 个 可 运行 环境 而 已 


这 里 使 用 `lib/read.js`， 而 且 是 使 用 
“data.task" 异 步 读 取 的 ， 这 是 让 我 们 
后 续 采取 顺序 编程 的 方式 编码 的 基础 。 
关于 “data.task”， 请 参阅 《函数 式 编程 


入 门 经 典 》 


这 里 使 用 ` lib/format.js”， 要 根据 
json 数 据 整 理 成 我 们 需要 的 形式 ， 函 
数 式 编程 的 身影 更 加 明显 


的 数据 de 过 记 寻 “ 避 - 这 站 灶 - 外 邓 opt 
a 4 “lib/config.js”， 是 针对 用 户 可 见 
实际 上 ， 解 析 工 作 给 了 Esprima , 这 里 


的 接口 参数 ， 方 便 修改 用 的 。 这 一 步 
主要 是 结合 需要 做 了 进一步 处 理 ， 最 终 ， 方便 人 
得 到 的 是 json 格 式 的 数据 就 已 经 得 到 了 `.pu "格式 的 文件 了 


这 里 使 用 `lib/generate.js”， 是 对 
`.pu 文件 的 一 步 简 单 操作 ， 仅 仅 为 


方便 而 已 


copyright(c) imfly 2016.09.02 http://bitcoin-on-nodejs.ebookchain.org 


图 19-2 js2uml 处 理 流程 


19.5 总 结 


VGN= 口 


关于 编码 的 方法 论 ， 第 18 章 和 第 19 章 已 经 讲解 得 足够 多 了 。 本 章 仅仅 是 为 函数 式 编程 提供 了 一 个 小 例子 。 例 子 本 身 并 不 完美 ， 没 有 收集 属性 变量 ， 也 没有 添加 测试 (实际 项 目 中 不 提倡 这 样 做 ) ， 很 多 
函数 式 编程 的 高 级 特性 也 都 没有 涉及 ， 不 能 算是 完全 的 函数 式 编程 ， 后 续 会 对 该 工具 进行 进一步 完善 和 提升 。 在 亿 书后 续 的 开发 中 ， 也 会 使 用 大 量 函 数 式 编 程 的 好 经 验 、 好 做 法 ， 进 一 步 压缩 代码 量 ， 提 高 


代码 的 健壮 性 和 可 维护 性 。 


凡事 过 犹 不 及 ， 尽 管 已 经 用 了 大 量 篇 幅 来 介绍 函数 式 编程 ， 但 是 并 不 代表 一 定 要 求 大 家 完全 使 用 函数 式 编程 来 进行 开发 ， 如 果 能 让 大 家 在 处 理 一 些 问题 的 时 候 不 自觉 地 使 用 一 些 函数 式 编程 的 方法 进行 
实践 ， 那 么 本 书 也 就 算是 达到 目的 了 。 比 如 ， 根 据 实 际 需要 ， 对 某 个 功能 、 模 块 ， 甚 至 仅仅 是 某 些 函数 ， 


适当 、 合 理 地 采用 函数 式 编码 的 方式 ， 就 已 经 足够 提高 工作 的 效率 和 代码 的 健壮 性 了 。 


19.6 参考 


js2uml: https://github.com/imfly/js2uml 

v0.1.0: https://github.com/imfly/js2uml/releases/tag/v0.1.0 

plantuml: http://plantuml.com/ 

Abstract syntax tree: https://en.wikipedia.org/wiki/Abstract syntax tree 

Fun with Esprima and Static Analysis: http://tobyho.com/2013/12/02/fun-with-esprima/ 
UglifyJS: https://github.com/mishoo/UglifyJS 


UglifyJS2: https://github.com/mishoo/UglifyJS2 


第 20 章 命令 行 开发 介绍 


在 Windows 系 统 盛行 的 年 代 ， 命 令 行 工 
都 被 大 大 简化 了 。 另 外 ，N 


odejs 平 台 的 出 现 也 让 开发 


一 度 被 忽视 ， 但 开发 人 员 如 果 掌 握 了 一 些 常用 命令 行 工具 的 使 用 ， 还 是 有 很 多 便利 的 。 命 令 行 工 
自己 的 命令 行 工具 变 得 轻松 简单 ， 给 编程 带 来 了 更 多 的 乐趣 。 


亿 书 整个 应 用 都 可 以 使 用 命令 行进 行 启动 。 从 前 面 章节 所 提供 的 源码 中 ， 可 以 注意 到 commander 组 件 的 应 用 ， 其 对 整个 appjs 程 序 都 起 到 了 至 关 重 要 的 作 上 
深入 探究 。 本 章 将 通过 一 个 实用 小 工具 ， 讲 解 使 用 commander 组 件 开 发 命令 行 工具 的 过 程 。 


20.1 


commander 


类 似 于 c 


ommanderl 


的 工 : 


了 ， 它 小 巧 灵活 、 简 单 易 


20.2 


commander 是 一 个 简单 、 


“commandert 是 一 个 组 件 


绝对 是 一 款 “您 值得 


权威 ， 


有 很 多 ， 但 它们 大 多 数 是 以 规范 命 
， 有 它 就 足够 了 。 


专注 3 


功能 实现 ， 不 需要 可 视 化 的 界 


， 无 论 是 开发 还 是 使 


HH 


命令 行 框架 最 为 合适 。 


旦 秘 


荐 有 ”的 组 件 。 


直接 的 命令 行 工 


， 说 明 它 是 第 三 


发 组 件 。 


事实 上 ， 在 Nodejs 或 Ruby 等 语言 环境 里 ， 只 需要 在 文件 的 头 部 添加 一 行 所 谓 的 shebang (提供 一 个 执行 环境 ) ， 就 可 以 将 代码 转换 为 命令 行 执行 了 。 
以 才 有 了 这 类 工具 的 出 现 ， 将 这 类 工具 称 为 


“ 命令 行 工具 开发 ，commander 的 英文 解释 是 命令 ， 正 如 其 名 字 所 表示 的 含义 一 样 ， 这 个 组 件 就 是 用 于 开发 命令 行 命令 的 。 


. 简单 直接 。 有 多 简单 ? 该 组 件 只 有 4 个 函数 而 已 。 有 多 直接 ? 如 果 你 了 解 “ 命 令 行 ” 的 话 ， 就 能 深刻 体会 到 ， 它 通常 包含 命令 、 


20.3 ”用 去 介绍 


下 面 将 对 commander 的 使 用 方法 概念 化 ， 称 为 “命令 行 


第 1 步 : 为 工具 命名 。 


为 工具 


选项 、 


因此 ， 只 要 记 住 commander 这 个 名 字 和 “ 它 是 一 个 简单 直接 的 命令 行 工 


发 


发 组 件 ” 这 一 句 话 的 概念 定义 ， 你 就 基本 上 已 经 掌握 了 该 组 件 的 


因为 命令 


帮助 和 业务 逻辑 4 个 部 分 ， 该 组 件 为 这 4 个 冯 


这 里 以 gitbook-summary (源码 托管 在 Github 上 ， 


命名 (这 里 的 工具 


commander 所 写 的 命令 是 一 个 动词 ( 


其 实 也 是 命令 ， 在 此 称 它 为 


命令 ) ， 


于 


区 分 系统 命令 ， 以 限定 命令 使 
实 是 用 .command () 方法 定义 的 子 命令 ) ， 比 如 generate， 最 后 的 形式 如 下 : 


也 址 见 20.6 节 ) 为 例 进行 说 明 。 


的 上 下 文 。 笔 者 通常 是 


。 为 了 进行 技术 积累 ， 我 们 有 必 


对 它 进行 


行 的 选项 处 理 和 流程 控制 比较 困难 ， 所 


令 行 选 项 为 主 ， 对 于 一 些 编码 细节 ， 还 需要 自己 实现 ， 比 如 : 何 时 退出 程序 (调用 process.exit (1) ) 等 。 但 commander 把 这 一 切 都 简化 


方 开发 的 ， 其 实 就 是 开发 Express 的 大 神 TJ (TJ Holowaychuk) 开发 的 。Ruby on Rails 语 言 也 有 一 个 同名 的 开发 组 件 ， 同 样 也 是 TJ 的 杰作 ， 所 以 ， 虽 为 组 件 ， 但 足够 


分 分 别提 供 了 对 应 的 


部 。 下 面 的 用 法 介绍 仅仅 是 帮助 您 更 好 地 记忆 和 使 用 。 


工程 的 名 字 或 操作 对 象 的 名 字 来 代替 ， 一 般 是 一 个 名 词 ， 比 如 book。 而 用 


$ book generate [--options] 
之 所 以 要 在 这 里 将 命名 单独 提出 来 ， 主 要 是 因为 在 Node.js 的 世界 里 ， 这 一 步 是 固定 不 变 的 ， 只 要 记 住 就 可 以 了 。 其 方法 是 在 package.json 里 定义 如 下 字段 : 
{ 

"bin™: 

"book": "./path/to/your-commander.js" 


} 
} 


@@ 注 齐 


字段 的 。 这 里 又 多 了 一 个 ，commander 请 求 bin 字 段 。 


如 果 不 使 


packagejson， 那 么 定义 的 就 是 node 命 令 之 下 的 子 命令 ， 调 有 


$ node ./path/to/your-commander.js generate [--options] 


如 果 连 node 都 不 想 输入 ， 那 么 就 要 在 代码 的 第 一 行 中 添加 shebang， 即 : 


#!/usr/bin/env node 


第 2 步 : 填充 4 个 函数 。 

这 一 步 用 于 定义 命令 、 选 项 、 帮 助 和 业务 逻辑 ， 完 全 是 commander 概 念 定义 的 使 用 。 其 实 ， 第 三 方 组 件 ， 也 起 到 了 这 种 微 框架 的 作用 。 关 于 其 
节 ) 了 。 这 里 需要 进一步 思考 的 是 ， 对 于 这 个 组 件 而 言 ， 这 4 个 函数 最 重要 的 是 什么 ? 

我 们 想到 的 通常 是 业务 逻辑 ， 不 过 请 注意 ， 只 要 是 开发 ， 逻 辑 部 分 自然 只 能 由 开发 者 自己 来 实现 ， 所 以 ，commander 只 是 提供 了 一 个 接 
是 一 个 提示 ， 仪 包含 了 简单 的 文本 信息 。 剩 下 的 各 种 选项 需要 规范 ， 也 最 为 关键 ， 这 才 是 commander 的 可 爱 之 处 。 那 些 提供 了 Ul 界 面 的 应 


方法 如 下 : 


ackage.json 文 件 是 包 配 置 文件 ， 是 全 局 配置 不 可 逾越 之 地 。 很 多 工具 都 是 基于 它 提供 入 口 程序 的 。 比 如 ，Node.js 就 是 请 求 main 字 段 的 (没有 定义 ， 默 认 请 求 index.js 文 件 ) ，NPM 是 请 求 scripts 


体 用 法 ， 最 好 的 学 习 方 式 就 是 看 官方 文档 ( 见 20.6 


] 函 数 而 已 ， 这 里 的 命令 只 是 一 个 名 称 而 已 。 此 外 ， 帮 助 也 只 


程序 ， 仪 仅 是 为 帮助 、 选 项 这 些 接 


提供 了 可 视 化 操作 而 已 。 


1) 命令 : 使 用 command 函数 定义 ( 子 命令 ) 。 例 如 如 下 代码 : 


Var program = require ("commander"); 


program 
.Command ("summary <cmd>") 
.alias ("sm") // 提供 一 个 别名 
.description ("generate a 'SUMMARY.md' from a folder") // 描述 , 会 显示 在 帮助 信息 里 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


当 使 用 -h 选 项 调用 命令 时 ， 上 述 命令 summary|sm 会 被 显示 在 帮助 信息 里 。 这 里 的 alias 和 description 只 是 锦上添花 。 


更 复杂 的 ， 例 如 下 面 官方 提供 的 例子 (https://github.com/tj/commander.js/blob/master/examples/pm) ，.command () 包含 了 描述 信息 和 .action (callback) 方法 的 调用 ， 也 就 是 说 ， 要 使 
子 命令 各 自 对 应 的 执行 文件 ， 这 里 是 ./pm-installjs、./pm-search.js 和 ./pm-list.js 等 。 


#!/usr/bin/env node 


Var program = require('http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/..'); 


program 
.version('0.0.1') 
.command('install [name]', 'install one or more packages') 
.command('search [query]', 'search with optional query') 
.command('list', 'list packages installed') 


.command ('publish', "Publish the package') 
.Parse (process .argv); 


@w 个 人 建议 最 好 使 用 command 方 法 直接 定义 主 命令 。 中 规 中 矩 地 定义 每 一 个 子 命令 (本章 中 统称 为 命令 ) ， 只 要 使 用 command 方 法 即 可 ， 不 带 描述 信息 ， 不 要 附带 action 方 法 。 如 果 定 义 了 类 似 于 
8&it 类 型 的 、 一 连 串 的 命令 ， 那 么 最 好 是 逐个 进行 定义 ， 这 样 做 显然 会 很 麻烦 ， 最 好 是 把 描述 信息 放 在 command 里 ， 去 掉 action 方 法 ， 这 时 将 会 默认 请 求 对 应 的 JavaSctipt 文 件 。 


2) 选项 : 使 用 option 方 法 定义 ， 可 以 理解 为 命令 行 数 据 结构 。 


该 函数 很 简单 ， 可 以 方便 地 将 文本 输入 转化 为 程序 所 需要 的 数据 形式 。 其 功能 具体 如 下 。 


“ 可 以 设置 任何 数量 的 选项 ， 


粘 


一 个 选项 对 应 一 个 .option 函 数 调用 。 

“ 可 以 设置 默认 值 。 

“ 可 以 提供 文本 、 数 值 、 数 组 、 集 合 和 范围 等 约束 类 型 (通过 提供 处 理 函 数 ) 。 
“ 可 以 使 用 正则 表达 式 。 


@i 对 于 option 方 法 ， 基 本 的 应 用 就 是 使 用 选项 名 称 和 描述 ; 复杂 一 点 的 应 用 就 是 要 提供 处 理 函 数 或 默认 值 ; 再 复杂 一 些 的 应 用 就 要 用 arguments 方 法 代替 option 方 法 ， 使 用 可 变 参 数 〈 带 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/16329/OEBPS/Text/.… 的 参数 ) 。 


3) 帮助 : 使 用 help 方 法 输出 一 切 有 用 的 描述 信息 ， 这 些 信息 通常 定义 在 命令 和 选项 中 。 例 如 : 


program.help (); 


如 果 要 定制 帮助 信息 ， 就 


program.on('--help', cb); 


4) 逻辑 : 使 用 action 方 法 注册 逻辑 ， 将 代码 转向 执行 自己 的 逻辑 代码 ， 当 然 也 可 以 不 用 git 类 型 的 多 命令 。 例 如 : 


program.action (function (cmd, options) { // code }); 


第 3 步 : 开发 业务 逻辑 。 


编写 action 可 以 调用 的 代码 就 可 以 了 。 


20.4 ”案例 分 析 


gitbook-summary 是 一 个 一 键 生成 gitbook 文 档 目 录 文 件 的 命令 行 工具 ， 可 以 把 一 个 文件 夹 下 的 全 部 文档 ， 快 速 归档 整理 成 一 个 markdown 格 式 的 目录 文件 。 这 个 文件 是 gitbook 生 成 电子 书 所 必需 
的 。 


笔者 从 来 不 愿意 为 写作 而 写作 ， 更 不 愿意 处 理 任 何 重复 性 的 工作 ， 因 此 每 隔 一 段 时 间 就 会 积累 一 堆 问题 清单 和 零 零 散 散 的 文档 。 这 个 命令 行 工具 基本 上 是 笔者 为 自己 定制 的 。 不 过 自发 布 以 来 ， 该 工具 
得 到 很 多 人 的 关注 ， 也 有 不 少 人 在 使 用 ， 并 且 有 很 多 小 伙伴 提交 了 改进 代码 。 


代码 非常 简单 ， 这 里 不 再 重复 粘贴 代码 ， 代 三 地 址 为 https://github.com/imfly/gitbook-summary。 具 体内 容 ， 请 读者 自行 查看 代码 。 


20.5 总结 


本 章 仅仅 介绍 了 commander 组 件 的 相关 概念 和 使 用 方法 ， 关 于 如 何 安装 (非常 简单 ， 只 要 一 条 命令 即 可 ) 、 如 何 修改 权限 ， 都 没有 细 说 。 网 上 已 有 很 多 关于 这 类 知识 的 资料 ， 请 读者 自行 查阅 学 习 。 


20.6 参考 


《Node.js 命 令 行 程序 开发 教程 》 (中 文 ) : http://www.ruanyifeng.com/blog/2015/05/command-line-with-node.html 


《用 npm 构 建 简单 命令 行 》 (英文 ) : http://blog.npmjs.org/post/118810260230/building-a-simple-command-line-tool-with-npm 


《用 Nodejs 开 发 命令 行 工具 》 (英文 ) : http://shapeshed.com/command-line-utilities-with-node.js/ 


《commanderjs 官 方 实例 》: https://github.com/tj/commanderjs/blob/master/examples/pm 


gitbook-summary 工 具 源 码 库 : https://github.com/imfly/gitbook-summary 


第 21 章 一 张 图 学 会 使 用 async 组 件 进 行 异步 流程 控制 


8.2 节 中 提 到 过 ， 在 Nodejjs 的 世界 里 “ 事 事 皆 回调” ， 学 习 使 用 Nodejs， 最 不 可 能 回避 的 就 是 “回调 ” (用 “ 调 回 ”可 能 会 使 其 意思 更 加 直观 些 ) 。 既 然 无 法 回避 ， 自 然 就 要 积极 面 对 ， 因 此 开源 社区 
出 现 了 很 多 关于 代码 流程 控制 的 解决 方案 ， 比 如 : bluebird、q， 以 及 本 章 要 图 解 的 async 组 件 。 


对 于 这 种 基础 性 的 技术 ， 社 区 中 有 极其 丰富 的 文档 介绍 ， 那 么 为 什么 本 书 还 要 专门 拿 出 一 章 来 做 介绍 呢 ? 因为 它 真 的 很 有 必要 ， 在 只 需要 顺序 编码 的 世界 里 ， 没 有 关于 回调 的 操作 流程 或 promise/a+ 规 
范 (服务 器 已 经 帮助 实现 了 ) ， 用 不 着 大 费 周章 ; 但 是 在 Node.js 的 世界 里 ， 学 习 并 掌握 这 样 一 种 方案 ,会 显著 提升 你 的 编码 能 力 。 


那么 ， 为 什么 要 介绍 async? 不 是 说 bluebird 的 性 能 更 好 吗 ? 原因 如 下 : 


@ 亿 书 大 量 使 用 了 aysnc， 掌 握 了 async 组 件 ， 对 亿 书 的 理解 和 后 续 的 编码 ， 会 起 到 事半功倍 的 作用 。 


尺 


@ 社 区 认可 度 高 、 文 档 丰富 、 使 用 简单 ， 且 对 代码 不 会 造成 污染 ， 无 论 是 学 习 还 是 使 用 ， 都 没有 风 


图 21-1 所 示 的 是 async 在 https://npmjs.org 上 的 依赖 排名 ， 除 了 lodash， 就 是 它 了 。 而 且 ，bluebird 和 q 也 都 位 列 前 10， 这 一 点 也 基本 说 明了 使 用 流程 控制 组 件 是 Node.js 处 理 回 调 的 标 配 。 


mostdepended-upon packages 
天 序 方向 
加 lodash ®@ async 图 request 
Lodash modular utilities. Higher-orderfunctions and common Patternsforasyn.. Simplified HTTP request client, 
46.1 published 3 weeks ago by dalton 2.0.0-rc.1 published 4 days ago by aearly 2569.0 published 2 months ago by mikeal 
图 underscore @ express @ commander 
JavaScript'sfunctional programming helper library. Fast, unopinionated, minimalist web framework the complete solution for node,js command-line progr... 
1.8.3 published 12 months ago by jashkenas 4134published2months ago by dougwison 290 published 5 months ago by zhiyelee 
图 debug @ chalk 图 bluebird 
small debugging utility Terminal string styling done right. Much color. Full featured Promises/A+ implementation with excep... 
2.2,0 published 10 months ago by tootalilnate 1L1 published 7 months ago by sndresorhus 334published 2 weeks ago by esaitia 
@q @ mkdirp 国 moment 
Alibrary for promises (CommonJS/Promises/A,8,D) Recursively mkdir, like ~ mkdir-p Parse, validate, manipulate, and display dates 
14.1 published 10 months ago by kriskowal 0.5.1 published 10 months ago by substack 212.0 published 2 weeks ago by chemev 


21-1 被 经 常 使 用 的 前 12 个 nbpm 库 


21.1 概念 定义 


关于 async， 官 方 介绍 如 下 : 


Async is autility module which provides straight-forward, powerful functions for working with asynchronous JavaScript. 


简单 翻译 就 是 : async 是 一 个 为 处 理 异 步 JavaScript 而 提供 的 简单 、 直 接 、 功 能 强大 的 实用 模块 。 


21.2 流程 类 别 


下 面 为 了 更 好 地 区 分 和 记忆 async 组 件 ， 笔 者 根据 个 人 的 理解 来 简单 汇总 一 下 。 全 部 流程 应 该 包含 以 下 三 种 情况 。 


1. 基 本 流程 


从 程序 (多 个 函数 ) 执行 顺序 的 角度 来 考量 ， 包 括 顺序 执行 、 并 行 执行 、 混 合 执行 等 基本 流程 。 如 果 还 要 考虑 图 数 间 是 否 有 依赖 、 是 否 限制 函数 执行 的 数量 等 ， 那 么 还 可 以 继续 演化 出 很 多 种 流程 。 


2. 循 环流 程 


基于 某 个 条 件 的 循环 操作 ， 根 据 条 件 使 用 的 方式 ， 循 环流 程 提 供 了 诸多 函 数 。 


3. 集 合流 程 


上 面 都 是 针对 一 个 或 一 组 数据 的 处 理 。 现 实 中 ， 通 常 要 对 大 批 相同 或 相似 的 数据 ， 比 如 大 批文 件 、 地 址 等 ， 进 行 集中 处 理 。 显 然 ， 我 们 的 第 一 反应 是 循环 调用 上 述 流程 即 可 ， 不 过 async 提 供 了 对 集合 进 
行 异步 操作 的 工具 方法 (util) ， 如 forEach 等 ， 这 里 就 称 它 为 “集合 流程 ” 吧 。 


使 用 流程 的 概念 可 以 明确 表示 ， 当 使 用 async.forEach () 的 时 候 ， 是 在 进行 异步 操作 ， 它 与 单纯 的 JavaScript 语 言 自身 提供 的 forEach 方 法 调用 是 有 区 别 的 。 


21.3 ”用 法 分 类 


async 提 供 了 70 多 个 实用 的 函数 ， 所 有 这 些 函 数 都 遵守 一 个 约定 : 所 定义 的 异步 函数 ( 当 作 一 个 任务 ) 的 最 后 一 个 参数 必须 是 callback 函 数 ; 该 callback 函 数 的 第 一 个 参数 必须 是 Error， 且 callback 函 数 
只 调用 一 次 。 


这 些 函 数 大 致 可 以 分 为 3 类 ， 它 们 分 别 对 应 上 面 的 3 种 流程 。 


1. 基 本 型 (一 次 多 任务 ) 


这 种 类 型 对 应 于 基本 流程 和 循环 流程 两 部 分 ， 用 于 一 项 事务 多 个 任务 的 操作 ， 其 调用 形式 为 


async.funName (tasks, callback (error, results) ) 


代码 中 的 funName 包 括 series、parallel (parallelLimit) 、waterfall、auto (autolnject) 等 。 这 里 的 tasks 既 可 以 是 Array 形 式 ， 也 可 以 是 JSON 形 式 ， 或 者 仅 支持 


中 的 一 种 。 


如 果 函 数 全 部 执行 成 功 ， 那 么 callback 里 的 results 也 会 对 应 tasks 的 形式 ， 将 已 经 执行 了 的 函数 结果 转化 为 Array 或 JSON 形 式 ; 如 果 tasks 中 有 一 个 函数 出 错 了 ， 则 会 终止 后 续 执 行 ， 调 用 callback、 
error 就 是 该 函数 的 错误 信息 ，results 或 许 仅 包 含 了 已 经 执行 的 结果 ， 或 许 同时 还 包含 了 未 执行 函数 的 结果 占 位 符 ， 再 或 许 什么 都 不 包含 直接 忽略 。 至 于 results 具 体 是 什么 ， 通 过 一 个 log 语 句 就 能 知晓 ， 不 
必 去 查 文档 。 


2. 循 环 型 (多 次 单 任务 ) 


根据 条 件 的 不 同 ， 可 以 使 用 下 面 的 形式 调用 循环 型 函数 : 


async.funName (test, fn, callback) 


或 : 


async.doFunName (fn, test, callback) 


代码 中 的 funName 包 括 whilst (doWhilst) 、until (doUntil) 、during (doDuring) 、retry (retryable) 、times (timesSeries，timesLimit) 、forever (因为 该 函数 已 经 暗含 了 条 件 ， 所 以 不 必 
使 用 test 了 ) 。 


这 里 的 条 件 值 既 可 以 是 表达 式 函 数 ， 也 可 以 是 具体 的 次 数 。 区 分 fn 与 test 的 顺序 很 简单 ， 只 要 按 英文 的 意思 去 理解 就 可 以 了 ， 比 如 async.doWhilst () ， 必 然 是 先 do， 后 whilst， 因 此 参数 自然 是 
async.doWhilst (fn, test, callback) 。 


3. 集 合 型 (多 次 单 任务 ) 


官方 没有 将 集合 型 当 作 流程 表述 ， 而 是 当 作 集合 的 操作 方法 来 提供 的 ， 集 合 型 函数 是 笔者 个 人 的 理解 。 笔 者 认为 将 它 归 为 流程 控制 可 能 会 更 易于 接受 和 理解 。 因 此 ， 仿 照 上 面 的 循环 型 调用 方法 ， 只 
将 条 件 test 改 为 一 个 集合 就 好 ， 集 合 全 部 使 用 数组 Array 的 形式 : 


async.funName (arr, iteratee, [callback]) 


代码 中 的 funName 包 括 : 


each, eachSeries, eachLimit 
forEachOf, forEachOfSeries, forEachOfLimit 
map, mapSeries, mapLimit 

filter, filterSeries, filterLimit 
reject, rejectSeries, rejectLimit 
reduce, reduceRight 

detect, detectSeries, detectLimit 
sortBy 

some, someLimit, someSeries 
every, everyLimit, everySeries 
concat, concatSeries 


当然 ，async 还 明确 提供 了 其 他 几 个 流程 控制 ， 比 如 compose、seq、applyEach (applyEachSeries) 、queue (priorityQueue) 、cargo、iterator、race 等 。 


另外 ， 还 有 几 个 Util (工具 ) 函数 ， 如 apply、nextTick、memoize、unmemoize、ensure-Async、constant、asyncify、wrapSync、log、dir、noConflict、timeout 等 ， 这 些 都 能 为 代码 编写 提供 
极 大 的 方便 ， 而 且 还 能 改善 代码 的 性 能 。 


21.4 脑 图 


可 以 将 上 述 的 解释 和 方法 ， 全 部 放 在 一 张 脑 图 里 (如 图 21-2 所 示 ) ， 然 后 再 结合 场景 ， 按 图 索 怠 ， 很 快 就 能 找到 正确 的 处 理 方法 了 。 


1. 源 码 解 读 


[ 


因为 在 第 10 章 中 已 经 提 到 过 async 在 亿 书 中 的 应 用 (如 


21-3 所 示 ) ， 这 里 不 再 歼 述 了 ， 后 续 章节 中 如 有 和 需要， 会 再 做 解释 的 。 


2. 趣 味 实践 


async 官 方 文档 中 提供 了 很 多 实例 ， 既 简单 又 直观 。 这 里 不 再 举例 ， 只 是 提出 一 个 趣味 性 问题 ， 以 供 大 家 思考 。 


问题 : aysnc 能 否 用 于 递归 调用 ， 比 如 某 个 胞 虫 程序 ， 用 于 遍历 某 个 文件 夹 下 全 部 文件 的 信息 等 ? 为 什么 ? 


中 定义 一 Async 是 一 个 为 处 理 异步 Js 提供 简单 直接、 强大 功能 的 实用 模块 
cl SS | async 提 供 了 70 多 个 实用 的 函数 
人 程序 员 所 定义 的 异步 函数 就 是 一 个 任务 ， 最 后 一 个 参数 必须 是 callback ( error, [.] ) 形式 的 函数 且 仅 被 调用 一 次 
asyn 的 因数 的 最 后 一 个 参数 多 数 是 callback ( error , fresults] ) 函数 , 随时 接收 并 处 理 失败 任务 的 error 信 息 
并 行 执行 、 串 行 执行 、 混 合 执行 
二 函数 一 series, parallel(parallelLimit), waterfall, auto(autolnject) 
c| Ose | +1 (ss) 
async funName(tasks, callback ( error, results ) ) 
这 里 的 tasks 可 以 是 Array 形 式 或 Json 形 式 
全 部 任务 成 功 callback 里 的 results 也 会 对 应 tasks 的 形式 ， 将 已 经 执行 函数 的 结果 转化 为 Array 或 Json 形 式 : 
某 个 任务 失败 一 终止 后 续 执 行 ; error 就 是 该 任务 传 过 来 的 错误 信息 ; results 会 比较 复杂 , 使 用 log 语 句 看 看 就 好 。 


© BR 一 whilst ( doWhilst) , until ( doUntil ) ，during ( doDuring ) , retry ( retryable ) , times ( imesSeries,timesLimit) 、forever 


日 用 法 


这 里 的 callback ( error, results ) 


async.flunName(test, n, callback) 或 asyncdoFunName(fn,test callback) 
这 里 的 条 件 值 tes 何 以 是 表达 式 函 数 ， 或 具体 的 参数 值 
© ER 一 each、forEachOf map.、 file、 reject detect，some、every、conca 革 系列 , 及 reduce、sortBy. 
S| Orne | Oan (seEs) 
日 肌 去 人 .async funName(arr, iteratee, [callback]) 
集合 全 部 使 用 数组 array 形 式 


| Oe | compose , seq , applyEach ( applyEachSeries ) , queue ( priorityQueue ) , cargo , iterator , race 等 
3 apply , nextTick , memoize , unmemoize , ensureAsync , constant, asyncify , wrapSync , log , dir, noConflict, fimeou' 筹 


国 -name>seres 一 与 <name> 相同 , 但 一次 仅 运行 一 个 任务 


Nodejs 流 程控 制 组 件 Async 全 解 扩展 六 遇 (2) <name>Limit 与 <zname> 相 同 ， 但 一 次 运行 最 大 值 为 mi 牙 量 的 任务 


下 西 有 这 种 扩展 函数 的 我 们 会 对 应 加 上 序号 1 用 | 


9 #5 一 paralleltasks, [callback) 1 
顺序 执行 ， 不 相互 依赖 ， 无 数据 文摘 
Series(tasks, [callback]) 
旬 asks 是 Array[ 戌 Json( 形 式 
日 囊 行 
执行 ， 彼 此 依赖 ， 前 者 的 办 出 为 后 者 的 术 入 
tasks 是 Array[ 于 5 式 
Cera oe 一 有 依 塘 关系 ， 有 的 并 行 ， 有 的 罕 行 
混合 


waterfall(tasks.[callback]) < 


autolnject(tasks, [callback]) ”一 auto 的 依赖 注入 版 本 
tasks 仅 Json( 开 式 

whilst(test, fn, callback) 一 doWwhilst(in, test callback) 
until(test, fn, callback) 一 doUntil(in, test, callback) 
tes 锂 验证 函数 

during(test, fn, callback) 一 doDuring(fn,test callback) 
forever(in, [errback]) 一 短 环 调用 名 自己 的 函数 


eachcoll, ileratee, [callbacd) 1 国 

forEachoftcoll iteratee, catback) 1 国 

maplcol, eratee, [callbacg) 1 国 

mertcol eratee, callbac) 1 国 

rejectcoll, iteratee, [calbacd) 1 国 

| Bw 上 a reduce(coll, memo, iteratee, [callback]) ”一 reduceRight(coll, memo, iteratee, [callback]) 
detect(coll, teratee, [calback) 1 天 


sortBy(coll, iteratee, [callback]) 
some(coll iteratee, [callbacx) 1 加 | 


everytcoll ieratee,[callbacg) 1 国 
concat(coll, iteratee, [callback]) 1 


applyEach(fns, args..., callback) 1 


这 里 的 函数 主要 是 用 在 流程 里 ， 起 到 辅助 功能 ， 也 可 单独 使 用 
compose(in1, tn2...) 
seq(in1, tn2..) 


applyEach(Ins, args..., callback) 1 


queue(worker, [concurrency]) 一 priorityQueue(worker, concurrency) 
cargo(worker, [payload)) 

retry(lopts = {imes: 5, interval: 0}| 5], task, {callback]) 。 一 retryable(Iopts = fimes: 5, interval: 0} 5], task) 
iterator(tasks) 

apply(function, arguments..) 

nextTick(callback, fargs_]), setimmediate(callback, [args..)) 

times(n, leratee, [calback) 1 国 

race(tasks, [callback]) 

memoize(fn, [hashem 一 unmemolze(fn) 

ensureAsync(In) 

constant(values.) 

asyncify(func) 

log(function, arguments) 

dir(function, arguments) 

noConfictD 


图 21-2 ”Node.js 流 程控 制 组 件 async 全 解 脑 


| 


parallelttasks function (err, results) { 
iaeachSeriestmodules function (module, cb) f 

» dbLite.js helpers 

» field.js helpers/validator 

b account.js logic 

P blocksJs modules 

b contacts,js modules 

P dapps.js modules 

p delegates.js modules 

by loader.js modules 

b multisignatures.js modules 

P PeerJs modules 

b round.js modules 

b sgljs modules 

b transactions.js modules 

> transport]s modules 

pr br app.js public/static/is 

P vendor_app.s public/static/)s 


A Variabljes.js test 
asyne doWhilst( 
Beie whilst(function () { 


图 21-3 async 在 亿 书 中 的 使 用 情况 (图片 中 的 数字 是 使 用 次 数 ) 


本 章 针对 一 项 老生 常 谈 的 技术 进行 了 讲解 ， 通 过 对 本 章 的 撰写 ， 笔 者 个 人 对 异步 操作 的 流程 管理 更 加 清晰 了 。aysnc 很 好 用 ， 但 也 不 是 万 能 的 ， 它 对 于 那些 反复 自 调 
的 回调 只 有 一 次 。21.6 节 收集 了 几 篇 比较 好 的 文章 ， 建 议 读者 自行 阅读 ， 继 续 深入 学 习 。 


的 代码 就 无 能 为 力 ， 因 为 限制 任务 


《async 官 方 文档 》: 
《Node.js 最 新 技术 栈 之 Promise 篇 》: https://cnodejs.org/topic/560dbc826aled28204ale7de 


《JavaScript Promise 迷 你 书 (中 文 版 ) 》: http://liubin.org/promises-book/#introduction 


客户 端 应 用 通常 是 区 块 链 产品 的 直观 表现 形式 ， 其 不 仅 扩 展 集成 了 很 多 实用 功能 ， 还 能 直接 面向 用 户 。 用 户 体验 的 好 坏 对 产品 形象 的 影响 很 大 ， 所 以 要 高 度 重视 客户 端的 开发 。 在 对 技术 的 选择 上 ， 前 
端 使 用 的 很 多 技术 都 可 以 在 这 里 使 用 。 


亿 书 计划 采用 前 端 开 发 框架 Emberjs 进 行 开发 ， 开 发 一 款 Web、PC 桌 面 、 移 动 等 多 终端 通用 的 组 件 ， 通 过 Electron 等 工具 进行 打包 集成 ， 以 适 配 多 平台 ， 这 也 是 当前 很 多 应 用 所 采取 的 方式 。 这 种 方式 
可 以 让 我 们 像 开 发 网 站 一 样 开发 客户 端 应 用 ， 从 而 大 大 降低 开发 难度 ， 提 高 开发 效率 。 


第 二 部 分 介绍 了 Nodejs 在 前 端 开发 中 的 应 用 ， 并 通过 具体 项 目 说 明了 Nodejs 在 比特 币 客户 端 领 域 已 得 到 广泛 应 用 。 当 时 为 了 介绍 Nodejs 入 门 技术 ， 一 切 都 是 从 头 创建 ， 没 有 引入 前 端 框架 。 但 在 具 
体 的 项 目 实践 中 ， 前 端 是 有 框架 可 供 选 择 的 ， 效 率 和 体验 会 有 明显 的 提升 。 关 于 哪 款 前 庙 框 架 最 合适 ， 也 要 因 人 而 异 ， 需 要 根据 具体 情况 具体 判断 。 网 上 对 各 前 端 框架 的 优 劣 仍然 争论 不 休 ， 本 书 就 不 做 讨 
论 了 。 总 之 ， 亿 书 选择 的 是 Emberjs。 


本 章 和 第 23 章 将 基于 Emberjs 介 绍 如 何 开发 通用 的 HTML 组 件 。 这 两 章 将 以 亿 书 官方 网 站 作为 实例 ， 本 章 先 整体 介绍 静态 网 站 的 类 型 、 技 术 选 型 ， 以 及 在 开发 亿 书 官网 时 体会 到 的 Ember 使 用 的 几 处 陷 
阱 ， 然 后 再 把 网 站 拆 分 为 各 个 组 件 。 第 23 章 将 通过 一 个 具体 插件 的 开发 过 程 来 讲解 开发 通用 HTML 组 件 的 基本 思路 和 方法 。 


亿 书 官网 地 址 : http://ebook 


亿 书 官网 源码 : https://github.com/Ebookchain/ebookchain.org 


亿 书 官网 1.0 版 本 主页 截图 如 图 22-1 所 示 。 


电子 书 。 文 省 博客。 俱乐部 | 用 人 


亿 书 : 为 人 类 创作 注入 新 动力 ! 


100000 =。 200000 , 300000 轩 


这 是 一 个 简单 的 静态 网 站 ， 如 果 不 考虑 其 可 扩展 性 ， 单 纯 使 


性 ， 我 们 引入 了 Emberjs 前 端 框架 。 


22.1.2 ”功能 特点 


图 22-1 


HTML+DIV+Javascript 的 形式 ， 对 于 美工 熟练 的 前 端 来 说， 用 


亿 书 官网 1.0 版 本 主页 截图 


天 的 时 间 就 能 制作 完毕 。 不 过 ， 考 虑 到 扩展 性 ， 以 及 后 续 多 平台 的 兼容 


可 能 会 有 读者 提出 疑问 : 一 个 静态 网 站 还 要 有 什么 特殊 功能 吗 ? 好 看 ， 能 传达 产品 信息 ， 不 就 行 了 吗 ? 其 实 不 然 。 亿 书 官网 主要 实现 了 以 下 几 个 功能 (很 多 网 站 也 有 这 些 功 能 ， 亿 书 将 它们 集中 到 了 一 


起 ， 因 此 可 以 将 亿 书 官网 作为 一 个 init 工 程 来 看 待 ) 。 


: 导航 动画 : 当 滚 动 页 面 的 时 候 ， 网 站 的 headet 会 动态 调整 。 笔 者 已 将 这 个 功能 抽出 做 成 了 Ember.js 的 插件 


FF ， 插 件 源码 地 址 为 https://github.com/imfly/ember-cli-animated-header。 


滚动 事件 : Ember.js 中 没有 包含 对 Scroll 事 件 的 处 理 。 笔 者 为 Ember.js 提 供 了 响应 Scroll 事 件 的 能 力 ， 抽 出 的 插件 源码 地 址 为 https:/ /github.com/imfly/ember-cli-scroller。 


SVG 动画 : 当 打开 网 站 的 时 候 ， 会 看 到 第 一 页 Ebookchain 的 动画 效果 。 


“ 全 页 展示 : 滚动 页 面 ， 页 面 会 按照 屏幕 逐个 显示 出 来 ， 并 自动 适 配 屏幕 大 小 。 封 装 的 插件 源码 地 址 为 https://github.comyimfly/ember-cli-fullpagejs。 


“ 多 语言 支持 : 提供 了 英文 和 中 文 两 种 语言 ， 默 认 是 英文 。 


: 模块 布局 : 产品 特征 、 合 作 伙伴 部 分 直接 采用 JSON 数 据 ， 完 全 按照 MVC 模 式 进行 分 离 ， 添 加 、 修 改 、 删 除 、 扩 展 都 很 方便 ， 无 须 修改 页 面 。 


: 自动 构建 : 一 键 导 出 静态 页 面 ， 合 并 压缩 JavaScript、CSS 等 文件 。 


“ 一 键 部 署 。 


多 语言 支持 和 可 扩展 性 显然 要 比 纯粹 的 静态 页 面 好 很 多 。 细 心 的 读者 一 定 会 发 现 类 似 的 3 


建立 类 似 的 主页 就 会 简单 得 多 。 


22.2 ”静态 网 站 开发 方案 


开发 静态 网 站 可 用 的 方案 也 有 很 多 ， 笔 者 尝试 总 结 了 如 下 三 种 。 


(1) 自己 开发 设计 


二 


为 了 延续 前 面 的 工作 ， 笔 者 最 初 在 第 二 部 分 提供 的 实例 程序 的 基础 上 构建 了 一 个 应 


码 已 被 废弃 删除 ) 。 


(2) 使 用 第 三 方 产品 


这 类 产品 也 被 称 为 静态 站 点 生成 器 ， 最 早 流行 的 是 WordPress。 不 过 ， 基 


向 技术 人 员 的 ， 因 此 要 具备 学 习 和 掌握 基本 安装 和 使 用 的 能 力 。 


页 非常 多 ， 有 的 基本 上 完 


一 样 。 


实 上 ， 很 多 


页 都 是 直接 复制 他 人 的 静态 页 面 ， 有 了 亿 书 官网 代码 之 后 ， 


于 输出 官方 主页 。 编 码 到 最 后 ， 笔 者 发 现 


自己 在 走 ember-cli 等 现 有 框架 产品 的 老路 ， 因 此 果断 放弃 ( 那 部 分 代 


FNodejjs 并 在 Github 上 被 广泛 关注 的 有 Wintersimith、Assemble、Metalsmith、Hexo、DocPad， 等 等 。 这 类 产品 多 是 面 


这 类 产品 的 特点 就 是 已 经 帮 你 解决 了 界面 主题 、 静 态 转化 和 部 署 等 技术 性 的 工作 ， 而 让 你 专注 于 内 容 的 创作 ， 极 大 地 简化 了 静态 页 面 的 生成 过 程 。 


(3) 借助 开发 框架 


个 性 化 的 产品 ， 当 然 还 得 自己 来 开发 设计 ， 只 不 过 代码 的 结构 和 后 期 的 处 理 可 以 交 由 现成 的 框架 产品 进行 。 这 样 既 保证 了 开发 设计 的 工作 效率 ， 又 可 以 获得 更 大 的 代码 处 理 自由 度 。 其 缺点 可 能 是 技术 


门槛 会 高 一 些 。 


亿 书 选择 使 用 Emberjs 作 为 前 端 开 发 框架 ， 涉 及 的 产品 主要 包括 官方 网 站 和 各 平台 的 客户 端 。 把 可 以 共享 的 部 分 全 部 抽取 出 来 ， 独 立 为 基本 的 组 件 ， 既 可 以 方便 各 产品 的 共享 使 用 ， 又 能 够 大 大 提高 产 


品 线 的 开发 进度 。 


22.3 与 Emberjs 的 “前 仇 上 日 恨 ” 


笔者 之 前 曾 接触 过 Emberjs， 当 时 的 discourse 论 坛 就 是 用 Emberjs 开 发 的 前 


不 过 ， 笔 者 试用 了 一 下 后 ， 发 现 用 后 台 的 思路 去 开发 前 端的 应 
最 为 严格 的 前 端 框架 ， 市 面 上 大 量 现成 的 第 三 方 开发 包 不 能 直接 简单 地 被 引入 使 


端 ， 功 能 酷 粮 ， 真 有 一 点 “ambitions” 


(Ember.js 当 时 的 宣传 口号 ) 的 感觉 。 


， 感 觉 很 多 东西 都 不 对 路 。 生 搬 硬 套 后 端的 MVC 模 式 ， 除 了 使 开发 变 得 更 加 复杂 之 外 ， 好 像 并 没有 太 大 的 突破 。 另 外 ，Ember.js 是 封装 
， 这 一 点 也 成 为 其 饱 受 诉 病 的 原因 。 


这 次 ， 笔 者 为 了 开发 亿 书 的 官方 网 站 ， 也 为 了 给 日 后 客户 端的 开发 选择 一 个 技术 方案 ， 重 新 试用 了 一 下 Emberjs， 发 现 Emberjs 的 改进 相当 大 。 在 此 ， 笔 者 真心 感谢 这 些 踏 踏实 实 做 事 的 团队 ， 他 们 真 


的 非常 “ambitions”。 


22.4 “理解 Emberjs 几 个 让 人 迷 乱 的 深 “ 坑 ” 


对 一 些 读者 来 说 ，Emberjs 的 学 习 曲 线 可 能 陡 了 些 。 本 节 先 列举 Emberjs 的 几 个 “不 良 ” 习 惯 ， 以 帮助 大 家 在 学 习 的 时 候 尽量 避 开 这 些 


Emberjs 的 入 门 文章 ， 在 此 就 不 再 重复 了 ， 这 里 只 是 对 笔者 个 人 所 理解 的 、 


22.4.1 ”什么 是 前 端 框 架 


很 多 貌似 高 深 的 东西 其 实 也 不 过 是 一 个 Javascript 文 件 而 已 。 


因此 ， 完 全 可 以 像 使 


需要 提醒 小 伙伴 们 注意 的 地 方 做 一 个 简 和 


其 


他 JavaScript 文 件 一 样 ， 在 | 


的 提示 。 


“ 坑 ”， 而 不 至 于 一 试用 就 被 泌 了 冷水。 网 上 有 很 多 关于 


里 引入 和 使 


Emberjs。 既 然 称 Emberjs 为 框架 ， 显 然 是 其 提供 了 特定 的 规 


则 ， 所 以 学 习 的 重点 就 是 要 掌握 这 些 规则 。 如 果 掌 握 不 好 ， 自 然 就 会 掉 进 它 的 “ 坑 ” 里 。 


之 所 以 这 么 说 ， 是 因为 Emberjs 的 官方 文档 做 得 实在 是 不 好 ， 它 没有 一 个 整体 的 概念 ， 有 时 候 还 会 让 人 感觉 无 法 理解 “为 什么 会 如 此 ”。 即 便 是 对 细节 的 介绍 ， 也 不 是 那么 细致 深入 ， 有 时 候 还 需要 结 
合 源码 去 理解 。 再 者 ， 版 本 、API 的 变化 有 些 太 快 。 虽 然 在 两 年 前 ， 就 已 经 有 人 提出 这 些 缺陷 ， 但 直到 现在 依然 没有 太 大 的 改进 。 


22.4.2 一 定 要 使 用 它 的 命令 行 工具 Ember-cli 


对 于 这 一 点 请 不 要 质疑 ， 虽 然 可 以 直接 使 用 JavaScript 文 件 ， 但 是 若 没有 Ember-cli 这 样 强 有 力 的 命令 行 工具 ， 直 接 使 用 Emberjs 的 话 ， 开 发 难度 会 陡 增 。 这 个 工具 会 让 开发 Emberjs 应 用 (如 开发 后 台 
程序 ， 特 别 是 用 惯 了 Ruby on Rails 的 朋友 ) 感到 非常 亲切 。 从 建立 工程 、 产 生 各 类 坎 辑 代码 ， 到 测试 、 部 署 ， 等 等 ， 该 工具 (或 通过 插件 ) 包抄 了 一 切 。 


22.4.3 ”在 浏览 器 上 安装 使 用 Ember-inspector 揪 件 


这 一 点 是 必需 的 。 通 过 该 工具 ， 可 以 掌握 生成 的 路 由 、 控 制 器 、 视 图 组 件 等 各 类 对 象 信 息 ， 以 及 它们 之 间 的 对 应 关系 ， 还 能 单 击 对 应 的 对 象 ， 以 查看 对 应 的 方法 和 所 加 载 的 数据 。 更 主要 的 
是 ，Emberjs 默 认 生成 的 路 由 和 视图 等 也 被 罗列 了 出 来 ， 如 indexRoute， 如 图 22-2 所 示 。 


日 四 回 
加 | < | (generated home controller) 
Deal 加 Own Properties 


animated-header ebookchaitemplates--， 一 


link-to (inine) - namespace: ebookchain 
store: <ebookchain@service:store“ember606> 


language-sele ebookchain/templates... 一 OWNER [id=_ember1460799648944471453620696]: 


home ebookchain/ternplates， 


fuihpage ebookchaintemplates..， 一 


ebc-vivus ebookchairtempiates 


ebc-footes ebookchaintemplates..， 一 


图 22-2 Ember-inspector 操 作 使 用 界面 


22.4.4 ”Emberjs 提 倡 的 MVC 模 型 里 没有 了 VC 


在 Emberjs 提 倡 的 MVC 模 型 里 ， 对 于 之 前 的 版 本 ，M 代 表 model，V 代 表 view (外 加 helper、component) ，C 代 表 controller， 路 由 route 单 独 存 在 。2.0 版 本 以 后 ， 这 个 模式 发 生 了 改变 ，VC 部 分 逐 
步 被 剔除 ， 取 而 代 之 的 是 router+model+component 的 形式 。 


或 者 说 ，V 的 内 容 变 成 了 component，C 的 内 容 放 在 了 router 里 。 在 笔者 个 人 看 来 ， 这 一 改变 应 该 是 理性 加 
是 一 个 对 概念 的 实现 ， 本 质 上 并 没什么 用 处 。 


归 ， 因 为 在 之 前 的 版 本 里 ，controller 能 做 的 事情 ，router 照 样 也 能 做 ， 留 着 controller 只 能 


当然 ， 截 至 本 章 写 作 之 时 ， 当 前 的 版 本 还 保留 着 控制 器 和 视图 (可 以 通过 插件 来 使 用 ) ,以便 程 序 员 兼容 之 前 的 程序 代码 ， 但 是 笔者 个 人 不 建议 使 用 。 


22.4.5 ”有 了 组 件 ， 自 然 就 没 了 全 局 模板 layout 和 局 部 模板 partial 


理解 这 一 点 非常 重要 。 一 方面 ，Emberjs 号 称 是 面向 未 来 的 组 件 ， 即 今天 开发 的 UI 组 件 component 在 以 后 也 能 被 使 用 。 在 以 后 的 版 本 里 ， 组 件 的 地 位 将 会 更 加 重要 。 所 以 ， 以 前 可 能 对 文章 列表 ， 比 如 
post-item 的 处 理 ， 就 是 写 一 个 局 部 模板 partial 来 实现 重用 ， 今 天 用 component 就 可 以 了 ，partial 不 再 被 支持 。 


另 一 方面 ，application.hbs 本 身 就 相当 于 是 一 个 layout.hbs 文 件 ， 作 为 单 页 面 应 用 ， 自 然 就 没有 所 谓 的 layout 的 存在 ， 这 与 在 后 台 使 用 handlebarjs 是 有 区 别 的 。 它 的 演 染 层次 如 图 22-3 所 示 。 


图 22-3 只 是 对 Emberjs 的 视图 演 染 过 程 进行 了 简单 的 描述 ， 用 动态 图 像 来 描述 才 会 更 加 直观 。 事 实 上 ， 它 还 可 以 更 复杂 一 些 ， 把 一 些 钩子 方法 也 放 进 去 ， 这 样 对 于 Emberjs 的 数据 传递 、 视 图 泻 染 等 过 
程 将 会 更 加 直观 。 


22.4.6” 玩 转 Emberjs 的 必 经 之 路 


掌握 路 由 、 模 型 、UI 组 件 等 各 部 分 的 钩子 方法 ， 是 玩 转 Emberjs 的 必 经 之 路 。 设 计 独 立 静止 的 页 面 没有 什么 难度 ， 所 以 简单 的 hello world 程 序 是 看 不 出 来 什么 的 。 现 实 是 ， 多 个 模型 的 关联 操作 、 路 由 
状态 的 转移 变更 、UI 组 件 的 交互 嵌 套 、 插 件 与 主 程序 的 良好 扩展 ， 这 些 才 是 开发 中 的 常态 ， 如 果 处 理 它们 觉得 简单 了 ， 那 才 真 叫 简单 。 各 部 分 之 间 的 关联 操作 多 是 通过 不 同 的 钩子 方法 来 实现 的 ， 请 认真 阅 
读 官方 文档 ， 并 在 实践 中 总 结 提升 。 


Header 


outlet: application 
blog.hbs -> http://localhost:4000/blogs/1 


comment.hbs -> http://localhost:4000/blogs/1/comments 
hihi hs hse ls a het edt Rett Sst Shei dh 


outlet: comment 


图 22-3 Emberjs 的 视图 泻 染 的 过 程 


22.4.7 ”学 会 插件 开发 ， 把 一 切 现成 的 插件 装 进 Emberjs 里 


Emberjs 因 为 吸收 了 Ruby on Rails 的 思想 ， 一 切 都 是 约定 优 于 配置 (convention over configuration) ， 所 以 规则 最 多 ， 约 束 最 强 ， 这 一 点 对 于 不 习惯 这 些 的 小 伙伴 来 说 会 很 不 适应 ， 同 时 也 导致 了 
它 的 入 门 比较 困难 (因为 要 学 习 和 适应 的 习惯 比较 多 ) 。 另 外 一 点 就 是 ， 在 强 约定 之 下 ， 扩 展 插件 的 开发 也 会 有 一 定 的 难度 ， 最 早 的 很 多 第 三 方 现成 的 JavaScript 应 用 根本 无 法 使 用 ， 关 于 这 点 现在 已 经 有 
了 较 大 的 改进 ， 也 诞生 了 很 多 优秀 的 插件 。 第 23 章 将 以 ember-cli-fullpagejs 插 件 为 例 ， 单 独 介绍 插件 的 开发 。 


在 进行 插件 开发 时 ， 有 一 个 最 容易 被 忽视 的 小 动作 一 一 这 一 点 不 是 Emberjs 本 身 的 问题 ， 但 Ember.js 的 插件 也 是 npm 包 ， 因 此 npm 的 问题 自然 也 是 它 的 问题 。 本 地 开发 调试 npm 包 时 (或 ember-cli 插 
件 ) ， 通 常会 使 用 npm link 和 npm link npm-name 两 个 命令 ,将 开发 的 hpm 包 引入 工程 。 最 容易 被 忽略 的 就 是 ， 运 行 完 命令 之 后 ， 还 应 在 工程 的 package.json 里 添加 对 该 包 的 依赖 ember-cli- 
pluginName: *“， 不 然 工 程 是 不 知道 的 。 


事实 上 也 有 不 需要 设置 的 ， 不 过 这 么 做 是 最 稳妥 的 方法 。 建 议 把 这 个 小 步骤 作为 一 个 固定 约束 ， 这 样 会 节省 很 多 时 间 。 


22.5 总结 


本 章 分 享 了 笔者 对 亿 书 官方 网 站 的 开发 体会 ， 具 体 源 代码 已 经 分 享 到 Github 上 (地 址 见 22.6 节 ) ， 这 里 就 不 一 一 罗列 了 ， 请 大 家 自行 阅读 。 在 写作 本 章 时 ， 亿 书 官网 所 涉及 的 源码 仍 在 整理 中 ， 还 未 添 
加 文档 和 测试 ， 功 能 也 不 健全 ， 如 果 大 家 喜欢 Emberjs， 希 望 进 一 步 学 习 交流 ， 欢 迎 参与 改进 该 项 目 ， 共 同学 习 提高 。 


Ember.js 是 一 个 值得 掌握 的 产品 ， 本 章 只 是 作为 引子 ， 更 多 信息 ， 强 烈 建 议 读者 认真 浏览 Ember.js 的 官方 网 站 。 第 23 章 将 介绍 它 的 插件 开发 ， 看 看 Ember.js 是 如 何 根据 需求 拆 分 并 开发 组 件 的 ， 以 及 它 
是 如 何方 便 地 利用 现 有 资源 的 。 


22.6 参考 


Ember.js 官 网 : https://emberjs.com 


Ember-cli 官 网 : http://ember-cli.com 


亿 书 官网 : http://ebookchain.org 


亿 书 官网 源码 : https://github.com/Ebookchain/ebookchain.org 


第 23 章 ”开发 通用 的 HTML 组 件 


懒惰 通常 是 麻烦 的 开始 。 大 多 数 程序 员 都 希望 


自己 的 工作 能 够 一 劳 永 逸 、 一 次 开发 且 处 处 


可 


， 这 一 点 成 了 大 家 追逐 的 目标 ， 笔 者 也 不 例 儿 


时 ， 因 为 不 喜欢 按照 设 定好 了 的 目录 去 撰写 ， 所 以 在 写作 过 程 中 
做 了 一 个 开发 语言 检索 统计 工具 ( 见 第 6 章 中 的 实例 ) ; 在 阅读 源码 时 ， 


反复 修改 目录 ， 于 是 就 做 了 一 个 小 工具 gitbook-summary; 在 写 入 门 文章 时 ， 


。 笔 者 最 初 在 网 上 发 布 《Node.js 区 块 链 开发 》 的 系列 文章 
为 要 反复 搜索 Github， 笔 者 就 把 检索 与 制图 集成 到 一 起 ， 


因 


为 手动 整理 UML 图 很 辛苦 ， 笔 者 就 开发 了 js2uml 工 


写作 的 ， 而 是 用 于 简化 Web 开 发 的 ， 希 望 以 后 有 
多 工作 量 。 


( 见 第 19 章 中 的 实例 ) 。 本 章 所 要 讲 的 是 另外 一 个 例子 ， 不 过 不 是 用 于 辅助 


起 来 能 更 方便 ， 这 也 算是 懒惰 的 成 果 之 一 。 与 这 些小 工 


相 比 ， 亿 书 算 作 


其 中 相对 较 大 的 项 目 了 。 这 些 工具 提高 了 笔者 的 写作 效率 ， 但 也 在 无 形 中 增加 了 很 


一 个 问题 的 解决 往往 意味 着 另 一 个 问题 的 诞生 ， 所 以 只 要 写作 和 工作 不 断 ， 与 之 相关 的 开发 也 就 不 会 断 。 还 好 ， 除 了 个 别 情况 下 会 有 点 压力 ， 笔 者 始终 是 享受 其 中 的 。 但 是 ， 作 为 一 个 完整 的 有 一 定 规 


模 的 项 目 ， 需 要 保证 每 个 功能 都 能 尽量 独立 ， 尽 量 做 到 可 重 


自主 控制 权 ， 那 么 这 样 的 框架 可 能 就 不 太 适 合 他 。 


无 论 是 什么 样 的 框架 产品 ， 如 果 一 个 框架 拒 现 有 的 很 多 工具 于 门 外 ， 那 么 它 必 然 不 会 被 广泛 接受 。Emberjs 约 束 性 较 强 ， 
做 了 很 大 的 改进 ， 具 备 很 好 的 扩展 能 力 ， 本 章 就 结合 ember-cli-fullpagejs 插 件 的 开发 过 程 ， 讲 解 Ember-cli 插 件 开 发 的 各 个 细节 。 下 面 我 们 就 来 看 看 把 一 个 第 三 方 库 打包 成 一 个 小 小 的 组 件 是 多 么 简单 。 


23.1 插件 简介 


样式 可 以 浏览 亿 书 官网 http://ebookchain.org， 或 者 参考 第 22 章 中 的 截图 。 


1. 源 码 


本 章 所 用 的 主要 源码 地 址 具体 如 下 。 


https://github.com/imfly/ember-cli-fullpagejs 


2. 使 有 


安装 使 


命令 : 


$ npm install ember-cli-fullpagejs --save-dev 


。 这 样 不 仅 能 够 方便 项 目 管理 ， 也 方便 代码 维护 ， 所 以 一 次 开发 和 处 处 可 
的 、 约 束 性 较 强 的 软件 产品 或 开发 平台 ，Emberjs 就 是 这 类 开发 框架 。 一 旦 学 会 ， 它 们 可 以 让 我 “一 劳 永 逸 ” 地 按照 一 种 罗 辑 思维 去 思考 和 解决 所 遇 到 的 问题 。 但 也 有 聪明 的 小 伙伴 更 喜欢 


应 该 体现 在 每 一 个 环节 。 这 种 思想 促使 笔者 更 倾向 于 选择 那 种 稳固 
自己 拥有 强大 的 


属于 笔者 的 个 人 爱好 ， 最 初 的 版 本 对 已 有 开发 包 的 兼容 性 较 差 ， 但 是 现在 已 经 


只 


然后 ， 在 模板 文件 里 ,使 


3. 必 须 的 HTML 结 构 


标签 { 众 full-pagejjHUVWfull-pagej} 代 替 <div id= "fullpage"> </div> 即 可 ， 


其 他 与 使 有 


fullPage.js 一 样 。 


{{#full-page}} 
<div class="section">Some 
<div class="section">Some 
<div class="section">Some 
<div class="section">Some 
{{/full-page}} 


section</div> 
section</div> 
section</div> 
section</div> 


为 了 在 一 个 区 域 里 创建 滑 块 ， 每 个 滑 块 默认 使 


包含 slide 类 的 元 素 : 


<div class="section"> 


"slide"> Slide 1 </div> 
lide"> Slide 2 </div> 
<div class="slide"> Slide 3 </div> 
<div class="slide"> Slide 4 </div> 
</div> 
4. 选 项 


可 以 直接 为 标签 添加 选项 ， 代 码 如 下 : 


{{#full-page autoScrolling="'true' navigation='true' anchors='["firstPage", "secondPage"]' }} 


{{/full-page}} 


@ 注 言 选项 值 必 须 使 用 单 引号 ,而 不 是 双 引 号 。 更 多 选项 及 其 定义 请 参考 https:/ /github.com/alvarotrigo/fullPage.js#options。 


23.2 概念 解 半 


1. 约 定 优 于 配置 


第 22 章 中 简单 罗列 了 Emberjs 的 几 个 注意 事项 ， 特 别提 到 “约定 优 于 配置 “ 
大 家 所 提倡 的 ， 本 来 是 好 事 ， 


(convention over configuration) 的 问题 ， 这 一 点 是 导致 很 多 小 伙伴 入 手 困难 的 根源 。 有 的 读者 会 感到 很 奇怪 ， 这 原本 是 


怎么 就 成 了 问题 了 呢 ? 是 的 ， 如 果 习 惯 了 (其实 就 是 记 牢 了 ) 约定 ， 开 发 难度 会 大 大 降低 ， 效 率 会 大 大 提高 ， 


因为 框架 本 身 已 经 帮 你 做 好 了 这 一 切 。 相 反 ， 如 果 记 不 住 那么 多 


约定 ， 或 者 根本 就 不 知道 其 中 有 这 样 的 约定 ， 那 么 这 些 约定 就 会 给 你 带 来 很 多 困扰 。 这 是 目前 我 们 在 学 习 很 多 所 谓 的 框架 知识 时 应 该 特别 注意 的 一 个 问题 。 这 类 框架 之 所 以 学 习 成 本 较 高 ， 一 方面 是 因为 规 


则 太 多 ， 另 一 方面 是 因为 规则 与 我 们 固有 的 习惯 冲突 太 多 。 


举 个 简单 的 例子 ,我 们 在 使 用 第 三 方 库 的 时 候 ， 比 如 下 面 例子 里 的 “fullPage. 
虑 一 下 ， 是 不 是 已 经 有 了 它 自己 的 规则 。 事 实 上 ， 在 Emberjs 框 架 之 下 ， 正 确 的 使 


js”， 通 常 要 使 


方法 是 先 在 index.js 文 件 里 使 F 


标签 来 引入 ， 接 着 按照 该 库 的 逻辑 去 做 就 是 了 。 但 作为 一 个 约束 性 较 强 的 前 端 框架 ， 类 似 的 工作 要 先 考 
app.import 引 入 文件 ， 然 后 使 用 组 件 的 生命 周期 ( 见 23.6 节 ) ， 通 过 合适 的 钩子 方法 来 


处 理 (这 里 就 是 didinsertElement () 方法 ) 。 如 果 仍 然 延 续 原来 的 做 法 ， 那 么 最 好 的 情况 是 得 不 到 任何 结果 ， 最 差 的 情况 是 得 出 了 奇怪 的 结果 。 


这 就 给 我 们 使 用 现 有 的 第 三 方 库 造 成 了 很 大 的 困扰 ， 原 本 大 量 现成 的 好 工具 ， 使 用 起 来 感觉 如 此 鉴 脚 。 很 多 小 伙伴 也 因此 直接 放弃 了 Ember.js， 转 投 其 他 约束 较 少 的 框架 去 了 。 这 里 我 们 不 去 衡量 框架 
的 优 劣 ， 还 是 直接 考虑 如 何 解决 这 点 小 问题 吧 。 下 面 这 个 小 例子 可 以 帮助 我 们 把 现 有 的 库 直接 改造 成 Ember.js 可 用 的 插件 ， 让 其 融入 Ember.js 体 系 ， 降 低 绑 定 难度 。 因 为 插件 开发 的 过 程 与 Ember.js 应 用 开 
发 有 很 多 相似 的 地 方 ， 只 不 过 多 了 一 些 简单 的 配置 而 已 ， 所 以 我 们 就 把 具体 的 开发 过 程 融 入 这 个 插件 开发 里 一 起 进行 介绍 。 当 然 ， 这 样 做 还 不 足以 介绍 Ember.js 的 方方面面 ， 至 少 目前 能 够 解决 笔者 认为 的 
最 困扰 我 们 的 地 方 ， 降 低 Emberjs 的 开发 难度 。 


2 .浏览 器 世界 里 的 组 件 


Emberjs 的 组 件 (component) 是 非常 重要 的 概念 ， 特 别 是 v2.0.0 版 本 之 后 ， 全 部 取代 了 视图 (view) ， 可 以 理解 为 Emberjs 的 一 切 都 是 组 件 ， 这 大 大 简化 了 解决 问题 的 逻辑 ， 也 与 浏览 器 保持 了 最 大 
的 兼容 性 ， 甚 至 还 可 以 兼容 未 来 的 浏览 器 标准 。 笔 者 个 人 觉得 ，Emberjs 团 队 从 此 终于 走出 了 Ruby on Rails 的 极 档 ， 开 始 真正 面向 前 端 了 。 毕 竟 把 所 有 功能 都 集中 到 一 个 浏览 器 页 面 里 ( 单 页 面 应 用 ) ， 还 
硬 生生 地 套用 MVC 模 式 ， 着 实 会 让 开发 者 纠结 不 已 。 


我 们 可 以 把 浏览 器 最 原始 的 按钮 、 链 接 、 下 拉 框 等 标签 元 素 当成 Ember.js 最 基本 的 组 件 来 理解 。 有 了 Ember.js， 就 可 以 把 一 篇 文章 、 一 个 列表 、 一 个 图 片 展示 区 域 处 理 成 一 个 组 件 ， 这 样 做 至 少 有 三 个 
好 处 : 一 是 ， 开 发 符合 MVC 的 要 求 ， 可 以 做 到 数据 与 模板 分 离 ， 就 像 开 发 一 个 独立 的 页 面 一 样 ， 思 路 清晰 ， 快 速 高 效 ， 二 是 ， 使 用 上 这 个 组 件 本 身 与 浏览 器 的 基础 组 件 没有 区 别 ， 非 常 简单 直接 ， 可 以 自由 


组 合谋 套 ; 三 是 ， 一 次 开发 任何 地 方 都 可 以 使 用 ， 甚 至 还 可 以 兼容 未 来 的 浏览 器 。 


大 家 看 Ember.js 的 官方 文档 ， 还 能 看 到 控制 器 (Controller) 和 模型 (Model) 的 概念 ， 其 实 它们 只 是 另 一 类 的 组 件 而 已 ， 可 以 将 它们 理解 为 组 件 的 扩展 。 如 此 以 来 ，Emberjs 的 使 用 就 被 简化 为 浏览 
器 组 件 的 开发 ， 而 且 使 用 Emberjs 开 发 的 组 件 功能 也 变 得 更 加 强大 ， 其 使 用 方法 与 浏览 器 普通 组 件 的 使 用 方法 没有 分 别 ， 这 样 无 论 开 发 还 是 使 用 都 被 极度 简化 了 。 如 果 再 理解 了 本 章 的 例子 ， 基 本 上 就 可 以 
将 任何 重复 性 的 功能 都 包装 成 各 种 组 件 ， 打 包 成 插件 ， 并 在 需要 的 时 候 直接 安装 上 这 些 插件 ， 然 后 就 可 以 随处 使 用 ， 这 样 就 又 一 次 达到 了 一 劳 永 逸 的 效果 。 


23.3 ”开发 过 程 


下 面 就 来 看 看 ember-cli-fullpagejs 的 完整 开发 过 程 吧 。 


23.3.1 ”插件 的 基本 情况 


1. 场 景 


Ember CLI 插 件 API， 当 前 支持 的 场景 具体 如 下 。 


: 通过 ember-cli-build.js 操 作 EmberApp ( 主 应 用 ) 。 
: 添加 预 处 理 器 到 默认 的 注册 表 。 

“ 提供 一 个 自 定 义 的 应 用 程序 树 与 应 用 程序 合并 。 
“ 提供 定制 的 专用 (服务 ) 中 间 件 。 


“ 添加 自 定义 模板 ， 为 主 程序 生成 相关 的 工程 文件 。 


2. 命 令 行 选项 


Ember CLI 有 一 个 addon 命 令 ， 其 包含 的 选项 具体 如 下 : 


ember addon <addon-name><optionshttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/...> 

Creates a new folder and runs ember init in it. 

--dry-run (Default: false) 

--Verbose (Default: false) 

--blueprint (Default: addon) 

--skip-npm (Default: false) 

--skip-bower (Default: false) 

--skip-git (Default: false) 


人 @ 注 意 。 一 个 插件 不 会 在 已 经 存在 的 应 用 程序 中 被 创建 。 


3. 创 建 插件 


创建 一 个 基本 插件 ， 代 码 如 下 : 


ember addon <addon-name> 


运行 该 命令 ， 就 会 产生 下 面 这 些 文件 : 


$ ember addon fullpagejs 
Version x.y.zz 
installing 
Create .bowerrc 
Create .editorconfig 
create tests/dummy/.jshintrc 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 


Create index.js 


Installing packages for tooling via npm 
Installed browser packages via Bower. 


23.3.2 ”插件 的 工程 结构 


通过 上 述 命令 ， 自 动 生成 插件 的 工程 目录 和 相关 文件 ， 插 件 工程 遵循 如 下 的 结构 约定 。 
: app/: 合并 到 应 用 程序 的 命名 空间 (意思 是 说 ， 这 里 的 文件 ， 在 使 用 该 插件 的 应 用 程序 里 ， 可 以 直接 调用 ) 。 


“ addon/: 插件 的 命名 空间 部 分 。 


“ blueprints/: 包含 插件 所 有 蓝图 的 模板 文件 ， 每 一 个 存放 在 一 个 独立 的 文件 夹 里 。 

“ Public/: 应 用 程序 使 用 的 静态 文件 ，css、images、fonts 等 ， 路 径 前 级 /your-addon/*。 
“test-support/: 合并 到 应 用 程序 的 tests/ 中 。 

“tests/: 测试 文件 夹 ， 包 括 一 个 “dummy” 测 试 应 用 和 验收 测试 助手 。 

“vendor/: 第 三 方 专 有 文件 ， 比 如 stylesheets、fonts、 外 部 包 ， 等 等 。 

“ ember-cli-build.js: 编译 设置 。 

“ package.json: Node.js 的 元 数据 、 依 赖 库 等 。 


“index.js: Node.js 的 入 口 (遵从 npm 约 定 ) 。 


1.packagejson 


插件 的 packagejson 文 件 ， 代 码 如 下 : 


{ 
"name": "ember-cli-fullpagejs"，// 插件 名 称 
"version": "0.0.1"，// 插件 版 本 
"directories": { 

ngoc™: "doc™, 

"best": "tegt” 


1 
"soripts": { 
"start": "ember server", 
"build": "ember build", 
"test": "ember test" 


}, 
"repository": "https:// github.com/repo-user/my-addon", 
engines": { 
"node": ">= 0.10.0" 


}, 
"keywords": [ 
"ember-addon" 
// 添加 更 多 关键 字 ， 便 于 分 类 插件 
"enber-addon": { 
// 插件 配置 属性 


"configPath": "tests/dummy/config" 


3 
"author": ""，// 你 的 名 字 
"license": "MIT"，// 协议 
"devDependencies": { 


"body-parser": "^1.2.0", 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/OEBPS/Text/... // 在 这 里 添加 专门 的 依赖 库 ! 


# 
} 


Ember CLI 将 通过 检测 每 个 应 用 的 依赖 包 的 package.json 文 件 ， 查 看 在 keywords 部 分 是 否 有 ember-addon 关 键 字 ， 从 而 检查 其 是 否 为 一 个 插件 。 我 们 还 可 以 添加 一 些 额 外 的 元 数据 来 更 好 地 分 类 该 插 


件 : 

"keywords": [ 
"ember-addon™", 
"fullpagejs", 
"fullpage.js" 

], 
2 插件 入 


所 谓 的 插件 入 口 ， 就 是 调用 插件 最 先 执行 的 文件 ， 每 种 编程 语言 都 需要 。 插 件 将 利用 npm 约 定 ， 寻 找 一 个 indexjs 文 件 作为 入 口 点 ， 除 非 通 过 package.json 文 件 的 “main” 属 性 指定 另 一 个 入 口 点 。 建 
议 使 用 index.js 作 为 插件 入 口 点 。 


产生 的 indexjs 文 件 是 一 个 简单 的 Javascript 对 象 (POJO) ， 可 以 自行 定制 和 扩展 ， 示 例如 下 : 


// index.js 
module.exports = { 
name: "ember-cli-fullpagejs', 
included: function(app, parentAddon) { 
Var target (parentAddon || app); 
// 在 这 里 ， 你 可 以 修改 主 应 用 (app) ”/ 父 插件 (parentAddon)〉 . 比如 ， 如 果 你 想 包括 
// 一 个 定制 的 执行 器 ， 那 么 你 可 以 把 它 加 到 目标 注册 器 中 ， 如 : 


// target.registry.add('js', myPreprocessor); 


在 构建 (build) 的 过 程 中 ，included 钩 子 方法 会 被 执行 ， 直 接 操作 主 应 用 程序 或 它 的 父 插件 ， 从 而 提高 插件 的 处 理 能 力 。 这 个 对 象 扩展 了 Addon 类 ， 所 以 任何 存在 于 Addon 类 的 钩子 方法 都 可 以 被 重 


写 ， 请 参考 23.4 节 。 


23.3.3 ”插件 的 开发 设计 


1. 添 加 插件 依赖 


下 面 将 需要 封装 的 第 三 方 包 fullpagejs 作 为 插件 的 依赖 包 封 装 到 插件 中 。 通 过 bower 安 装 客户 端 依赖 : 


bower install --save-dev fullpagejs 


上 述 命令 将 自动 添加 bower 组 件 到 开发 依赖 中 : 


// bower.js 
{ 


"name": "ember-cli-fullpagejs", 
"dependencies": { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
"fullpage.js": "^2.7.8" 
} 
} 


2. 定 制 组 件 


下 面 将 fullpagejs 定 制 成 一 个 普通 的 浏览 器 组 件 ， 希 望 可 以 这 样 使 


导 


{{#full-page autoScrolling='true' navigation='true' }} 


{{/full-page}} 


先生 成 组 件 ， 然 后 就 可 以 使 用 下 面 的 命令 了 : 


$ ember generate component full-page 


组 件 名 称 中 至 少 要 有 一 个 “-” ( 短 模 杠 ) ， 这 是 约定 ， 请 记 住 。 这 个 命令 会 自动 生成 必要 的 文件 以 及 测试 文件 ， 只 要 在 里 面 添加 钦 辑 代码 就 是 了 。 为 了 允许 应 用 程序 不 用 手动 导入 语句 而 使 用 插件 组 


件 ， 应 该 把 组 件 放 在 应 用 程序 的 命名 空间 之 下 ， 即 app/components 目 录 之 下 ， 上 面 的 命令 已 经 帮 你 自动 生成 了 ， 代 码 如 下 : 


// app/components/full-page.js 


export { default } from 'ember-cli-fullpagejs/components/full-page'; 


这 行 代码 将 从 插件 路 径 导 入 组 件 ， 再 导出 到 应 用 程序 。 实 际 组 件 的 代码 是 放 在 addon/components/full-pagejjs 中 的 : 


import Ember from 'ember'7 


export default Ember.Component .extend({ 
tagName: 'div', 
// 这 里 的 选项 与 fullPage.js 包 的 选项 是 一 致 的 ， 请 参考 : https:// github.com/alvarotrigo/fullPage.js#options 
options: { 
// Navigation 
menu: '#menu', 
lockAnchors: false, 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16329/0EBPS/Text/... 
}, 


didRender() { 
Ember.run.scheduleOnce ('afterRender', this, function() { 
var options = clone (this, this.options); 
Ember.$ ("#fullpage") .fullpage (options); 
1D); 
}, 


willDestroyElement () { 
Ember.$.fn.fullpage.destroy ('all'); 
} 
1D); 


Ember.js 组 件 泻 染 之 后 的 标签 ， 默认 为 <div> </div> ， 如 果 需 要 将 其 修改 为 其 他 的 标签 ， 比 如 span， 则 可 以 定义 tabName 属 性 来 重 写 。didRender () 和 willDestroyElement () 是 两 个 钩子 方法 ， 


属于 组 件 生命 周期 的 一 部 分 ， 前 者 将 在 组 件 被 全 部 演 染 之 后 再 执行 ， 后 者 将 在 元 素 销毁 (通常 是 页 面 刷新 的 时 候 ) 的 时 候 执行 ， 因 为 Emberjs 是 一 个 
Ember.$ 都 始终 保持 在 那里 ， 所 以 必须 手动 清理 。 


这 里 的 问题 是 ， 为 什么 使 用 didRender () ， 而 不 是 didinsertElement () 钩子 方法 ”按照 官方 提供 的 文档 说 明 ， 前 者 在 页 面 初始 渲染 及 再 次 渲染 (刷新 ) 的 时 候 都 是 可 


时 候 使 用 。 也 就 是 说 ， 前 者 既 可 以 保证 刷新 页 面 ， 也 能 保证 刷新 效果 ， 而 后 者 则 只 能 在 加 载 页 面 时 才 有 效果 ， 这 也 是 约定 好 了 的 。 


页 


回避 


， 无 论 你 如 何 跳 转 或 刷新 ， 全 


志 二 后 
局 变量 


的 ， 而 后 者 仅 在 初始 泻 染 的 


这 里 还 需要 重点 解释 的 是 ， 这 个 组 件 也 按照 “约束 优 于 配置 ”的 原理 进行 了 处 理 。 比 如 : 默认 被 { 供 full-page}} 标 签 包围 的 代码 ， 会 被 包 庄 在 <div id= "fullpage"> </div> 里 ， 这 就 避免 了 用 户 忘记 设置 
id， 而 导致 出 现 错误 。 另 外 ， 对 选项 (options) 的 处 理 ， 默 认 选 项 也 都 放 在 了 属性 options 之 下 了 ， 但 是 我 们 可 以 在 使 用 中 去 重 写 ， 比 如 {{f#full-page autoScrolling='true'navigation='true'， 这 里 就 使 


了 Emberjs 对 组 件 的 一 种 默认 处 理 方法 ， 即 写 在 组 件 标签 里 的 选项 ， 自 动 成 为 该 组 件 对 象 的 属性 
将 它们 重 写 到 options 中 就 是 了 。 看 代码 很 简单 ， 但 其 中 却 隐 含 了 诸多 知识 点 ， 这 也 是 文档 中 没有 直接 提供 的 。 


23.3.4 加 载 第 三 方 库 


1. 默 认 蓝 图 模板 


因此 autoScrolling 和 navigation 自 然 就 成 为 full-page 组 件 的 


属性 之 一 ， 然 后 通过 自 定义 的 clone 方 法 ， 


所 谓 的 蓝图 模板 ， 就 是 我 们 在 安装 插件 的 时 候 ， 应 该 如 何 把 Javascript 或 CSS 文 件 加 载 到 主 程序 中 。 比 如 在 本 例 中 ， 安 装 插件 的 时 候 应 该 把 fullpagejs 下 载 到 主 程序 里 。 为 创建 蓝图 模板 添加 一 个 文件 


blueprints/ember-cli-fullpagejsindexjs， 这 是 标准 的 Emberjs 蓝 图 模板 的 命名 约定 : 


module .exports = { 
description: 'ember-cli-fullpagejs', 


normalizeEntityName: function() { 
// allows us to run ember -g ember-cli-fullpagejs and not blow up 
// because ember cli normally expects the format 
// ember generate <entitiyName><blueprint> 

}, 


afterInstal1: function(options) { 
return this.addBowerPackageToProject ('fullpage.js', '^2.7.8'); 
} 
}; 


2. 加 载 库 文件 


接 下 来 就 可 以 把 它 导 入 主 应 用 程序 了 ， 需 要 在 index:js 文 件 里 ， 使 用 included 钩 子 以 正确 的 顺序 导入 这 些 文件 ， 代 码 如 下 : 


// index.js 
module.exports = { 
name: 'ember-cli-fullpagejs', 


included: function included(app) { 
this._super.included (app); 


// workaround for https:// github.com/ember-cli/ember-cli/issues/3718 
if (typeof app.import !== 'function' && app.app) { 
app = app.app; 
} 
var fullpagejsPath = path.join (app.bowerDirectory, 'fullpage.js/dist'); 


app. import (path.join (fullpagejsPath, 'jquery.fullpage.min.css')); 
app. import (path.join (fullpagejsPath, 'jquery.fullpage.min.css.map'), { 


GestDir: "assets' 
Ds 


app.import (path.join (fullpagejsPath, ‘jquery.fullpage.min.js')); 
app.import (path.join (fullpagejsPath, ‘jquery.fullpage.min.js.map'), { 
destDir: "assets' 

]) 


这 一 步 就 相当 于 我 们 平常 使 用 的 <script> </script> 标 签 ， 不 过 这 里 这 样 使 用 的 好 处 是 ， 可 以 直接 压缩 打包 进 主 程序 。 


3. 导 入 静态 文件 


辐 片 、 字 体 等 静态 文件 通常 是 存放 于 /public 文 件 夹 中 的 ， 比 如 有 一 张 图片 可 以 保存 在 your-addon/publicimages/foo.png 的 路 径 下 ， 使 用 的 时 候 可 以 这 样 调 


.foo {background: url("/your-addon/images/foo.png"); } 


4. 高 级 定制 


一 般 来 说 ， 如 果 想 要 更 高 级 的 控制 ， 那 么 可 以 使 用 indexjs 中 一 些 插件 对 象 的 可 用 钩子 ( 键 ) 。 所 有 的 钩子 都 希望 将 一 个 函数 作为 它 的 值 (钩子 都 应 该 是 函数 ) : 


includedCommands:function() {}, 
blueprintsPath:// return path as String 
preBuild: 

postBuild: 

treeFor: 

contentFor: 

included: 

postprocessTree: 

serverMiddleware: 

lintTree: 


比如 ， 这 里 的 contentFor 钩 子 方法 可 以 在 主 程序 index.html 里 含有 {{content-for"header"} 标 签 的 地 方 插入 对 应 的 内 容 。 


23.3.5 ”测试 插件 


插件 工程 包含 一 个 /tests 文 件 夹 ， 该 文件 夹 包含 了 运行 和 设置 插件 测试 的 基本 文件 。/tests 文 件 夹 的 结构 如 下 : 


/dummy 
/helpers 

/unit 
index.html 
test_ helper.js 


* /dummy 文 件 夹 包含 一 个 基本 的 dummy 应 用 ， 用 于 测试 插件 。 

. /helpers 文 件 夹 包含 各 类 qunit 助 手 ， 包 括 为 了 保持 测试 简洁 而 自 定义 的 。 

“ /unit 文 件 夹 包 含 单元 测试 ， 用 于 测试 插件 ， 可 用 于 各 种 可 用 场景 。 

“integration/ 文 件 夹 包含 的 是 集成 测试 。 

“ test_helper.js 是 应 该 在 任何 测试 文件 中 引用 的 主要 帮助 文件 ， 它 导入 了 resolver 助 手 ， 可 以 在 /helpers 文 件 夹 中 找到 ， 用 于 解析 dummy 中 的 页 面 。 
“index.html 包 含 浏 览 器 中 加 载 的 测试 页 面 ， 以 显示 运行 单元 测试 的 结果 。 


关于 如 何 设置 和 运行 测试 ， 请 查看 官方 文档 。 


23.3.6 ”蓝图 模板 


蓝图 模板 是 一 些 具 有 可 选 安 装 逻 辑 的 模板 文件 。 它 用 于 根据 一 些 参 数 和 选项 生成 特定 的 应 用 程序 文件 。 一 个 插件 可 以 有 一 个 或 多 个 蓝图 模板 。 


1. 创 建 蓝图 模板 


为 插件 创建 一 个 blueprint : 


ember addon <blueprint-name> --blueprint 


按照 惯例 ， 插 件 的 主要 蓝图 模板 应 该 具有 与 插件 相同 的 名 称 : 


ember addon <addon-name> --blueprint 


在 我 们 的 例子 中 ， 可 使 用 如 下 命令 : 


ember addon fullpagejs --blueprint 


这 将 为 插件 产生 一 个 文件 夹 blueprints/ember-cli-fullpagejs， 在 这 里 可 以 定义 蓝图 模板 的 逻辑 和 模板 文件 ， 可 以 为 一 个 插件 定义 多 个 蓝图 模板 。 最 后 加 载 的 蓝图 模板 会 覆盖 现 有 的 (同名 的 ) 蓝图 模 
板 ， 该 模板 可 以 来 自 于 Emberjs 或 其 他 插件 。 


2. 蓝 图 模板 约定 


蓝图 模板 应 该 放 在 插件 根 目录 的 blueprints 文 件 夹 下 ， 就 像 覆盖 工程 根 目录 的 蓝图 模板 一 样 。 如 果 将 它们 放 在 插件 的 其 他 目录 下 ， 则 需要 通过 设置 插件 的 blueprintsPath 属 性 告诉 ember-cli 和 到 什么 地 方 
找到 它 。 要 想 更 深入 地 了 解 蓝图 模板 的 设计 原理 ， 请 查看 Ember CLI blueprints (https://github.com/stefanpenner/ember-cli/tree/master/blueprints) 。 


3 .模板 文件 结构 


blueprints/ 
fullpagejs/ 
index.js 
files/ 
app/ 
components/ 
name 
unbutton 
index.js 
files/ 
config/ 
_name .js 


@t 读 这 里 被 命名 为 _name。 的 特殊 文件 或 文件 夹 ， 将 (在 运行 命令 时 ) 在 主 应 用 程序 中 产生 一 个 文件 /文件 夹 ， 并 用 第 一 个 命令 行 参 数 (name) 代替 ”name 。 


$ ember g fullpagejs my-button 


由 此 将 会 在 主 应 用 程序 中 产生 一 个 文件 夹 app/components/my-button。 


23.3.7 ”辅助 工具 


1. 开 发 时 链接 插件 


当 开 发 和 测试 的 时 候 ， 可 以 在 插件 工程 的 根 目录 中 运行 npm link， 这 样 就 可 以 通过 插件 名 称 在 本 地 使 用 该 插件 了 。 然 后 ， 在 计划 使 用 的 应 用 程序 工程 根 目录 中 运行 npm link<addon-name> ， 就 会 将 
插件 链接 到 应 用 程序 的 node_modules 文 件 夹 下 ， 并 添加 到 packagejson 文 件 中 。 这 样 ， 插 件 中 的 任何 改变 都 会 在 链接 该 插件 的 任何 工程 中 直接 发 生 作用 。 


需要 注意 的 是 ，npm link 不 会 像 使 用 安装 命令 时 那样 运行 默认 的 蓝图 模板 (也 就 是 不 会 调用 钩子 方法 ， 下 载 或 生成 相关 的 库 文件 ) ， 需 要 使 用 ember g 来 手动 处 理 。 另 外 ， 当 我 们 使 用 这 种 链接 方式 测 
试 插件 的 时 候 ， 还 需要 提供 合法 的 版 本 信息 "<addon-name>":“"version"， 后 面 的 version 可 以 使 用 “*” 来 代替 ,而且 | 旧 版 本 的 npm 可 能 需要 手动 添加 到 package.json 中 。 


2. 发 布 插件 


可 以 使 用 npm 和 git 来 发 布 插件 ， 就 像 一 个 标准 的 npm 包 一 样 : 


npm Version 0.0.1 

git push origin master 
git push origin --tags 
npm publish 


3. 安 装 和 使 用 插件 


为 了 在 主 应 用 中 使 用 插件 ， 可 以 使 用 如 下 的 命令 来 安装 该 插件 : 


npm install ember-cli-<your-addon-name-here> --save-dev 


对 于 fullpagejs 插 件 ， 可 以 这 样 使 


npm install ember-cli-fullpagejs --save-dev 


运行 fullpagejs 蓝 图 模板 : 


ember generate fullpagejs 


4. 更 新 插件 


可 以 像 更 新 Ember.js 应 用 一 样 ， 通 过 在 工程 的 根 目录 下 运行 ember init 命 令 ， 更 新 一 个 插件 。 


23.4 ”Emberjs 的 多 子 方法 介绍 


23.4.1 contentFor 钩 子 方法 


范围 : 这 是 一 个 插件 的 钩子 方法 。 


途 : 该 方法 可 以 在 构建 时 被 调用 ， 直 接 在 content-for 标 签 处 插入 所 需要 的 内 容 。 如 果 不 是 开发 插件 的 话 ， 那 么 直接 忽略 它们 就 行 了 。 


到 content-for 标 签 ， 类 似 于 {{content-forhead}}、{{content-forbody}， 它 们 需要 等 待 某 个 插件 的 contentFor 钩 子 方法 注入 内 容 。 代 码 如 下 : 


描述 : 在 默认 生成 的 app/index.html 里 ， 有 几 处 会 


// index.js 
module.exports = { 
name: 'ember-cli-display-environment', 


contentFor: function(type, config) { 
if (type === 'environment') { 
return '<hl>' + config.environment + '</hl>'; 
} 
} 
$ 


不 管 {{content-for'environment' 在 什么 地 方 ， 这 段 代码 都 将 插入 程序 正在 运行 的 当前 环境 中 。contentFor 钧 子 方 法 会 为 每 一 个 index.html 下 的 content-for 标 签 调用 一 次 。 


23.4.2” 写 入 命令 行 


范围 : 插件 方法 。 


途 : 代替 console.log， 向 命令 行 输出 信息 。 


描述 : 每 个 插件 都 被 发 送 到 父 应 用 的 命令 行 输出 流 的 实例 中 ， 因 此 在 插件 的 indexjs 文 件 里 ， 输 出 信息 到 命令 行 ， 需 要 


到 this.ui.writeLine， 而 不 是 console.log。 例 如 : 


// index.js 
module.exports = { 
name: 'ember-cli-command-line-output', 


included: function(app) { 
this.ui.writeLine('Including external files!'); 
} 
} 


23.4.3 ”其 他 钩子 方法 


includedCommands: function() {}, 
blueprintsPath: // return path as String 
preBuild: 

postBuild: 

treeFor: 

contentFor: 

included: 

postprocessTree: 

serverMiddleware: 

lintTree: 


范围 : 插件 ， 而 且 是 在 插件 的 indexjs 文 件 里 。 


23.5 总结 


本 章 通 过 实例 详细 描述 了 利用 Emberjs 框 架 ， 把 一 个 第 三 方 库 封装 为 一 个 可 以 重用 的 组 件 的 方法 (当然 ,该 组 件 要 在 Ember.js 框 架 之 下 使 用 ) ， 简 化 了 第 三 方 库 的 使 用 方法 ， 为 我 们 使 用 Emberjs 扫 除 
了 一 个 障碍 。 但 是 反 过 来 说 ， 本 章 可 能 并 不 适合 那些 刚 入 门 的 小 伙伴 阅读 和 使 用 ， 因 为 本 章 包 含 了 大 量 的 基础 知识 点 ， 需 要 自行 浏览 官方 文档 来 补充 ， 然 后 再 结合 本 文 ， 进 行 深 层次 的 思考 。 


笔者 个 人 觉得 ，Emberjs 的 目标 和 代码 给 了 我 很 大 的 触动 ， 它 确实 适合 做 比较 综合 的 大 项 目 ， 比 如 亿 书 这 类 应 用 ， 大 部 分 功能 都 将 被 集中 到 客户 端 里 ， 所 以 用 Emberjs 开 发 将 非常 方便 。 但 是 这 并 不 代 
表 您 也 可 以 选择 Emberjs 来 进行 开发 ， 所 以 做 自己 喜欢 、 擅 长 和 有 价值 的 事情 ， 才 是 成 功 的 开端 。 


23.6 参考 


《developing addons and blueprints》: https://ember-cli.com/extending/#developing-addons-and-blueprints 
《组 件 的 生命 周期 》: https://guides.emberjs.com/v2.8.0/components/the-component-lifecycle/ 

fullPagejjs: https://github.com/alvarotrigo/fullPage.js 

《插件 的 钩子 方法 (hooks) 文档 》: https://ember-cli.com/api/classes/Addon.html 


《contentFor 钧 子 方法 》: http://ember-cli.com/api/classes/Addon.html#method_contentFor 


第 24 章 三 张 图 让 你 全 面 掌握 加 密 解密 技术 


密码 学 技术 的 涉及 面 很 广 ， 本 章 将 汇总 前 人 的 研究 成 果 并 通过 图 表 的 形式 来 帮助 大 家 进行 记忆 和 筛选 ， 以 方便 日 后 使 用 。 本 章 内 容 主 要 包括 两 个 方面 : 一 方面 是 场景 与 算法 ， 另 一 方面 是 Node.js 的 相关 
模块 或 组 件 ， 共 包含 3 张 脑 图 。 


24.1 ”密码 学 纵览 


图 24-1 是 在 “密码 学 一 小 时 必 知 ” (24.5 节 中 有 该 文 的 链接 地 址 ) 的 基础 上 完成 的 ， 原 作者 是 Colin Percival， 是 密码 学 方面 的 专家 、FreeBSD 项 目的 安全 长 官 、Tarsnap 在 线 备份 服务 的 创始 人 、 
scrypt 密 钥 衍 生 算法 的 作者 ， 这 篇 文章 非常 值得 参考 和 学 习 。 


网 


到 24-1 所 示 为 密码 学 中 的 概念 、 目 的 、 案 例 和 最 佳 实践 的 脑 图 。 


图 24-1 ”密码 学 中 的 概念 、 目 的 、 案 例 和 最 佳 实践 的 脑 图 


24.2 ”场景 与 算法 


图 24-2 是 基于 博客 文章 《现代 密码 学 实践 指南 (2015 年 ) 》 ( 见 24.5 节 ) 完成 的 。 可 以 说 ， 在 图 24-1 的 基础 上 ， 图 24-2 更 加 具体 ， 特 别 是 对 于 场景 的 描述 ， 让 程序 员 可 以 更 加 方便 地 做 出 正确 的 选择 ， 
值得 好 好 收藏 和 查看 。 其 中 ， 标 注 序号 的 是 有 优先 级 的 。 


RSAPKCSV15 加 ec xssooumr 
et 昌吉 | 四 cnaaazorovtaos8 
RSA 
@ soums 
时 他 在 全 t 人 一 种 新 9:t 本 而 
一 个 和 RubYy Gems 或 襄 Vagrant mges 文 伯 答 各 的 系 编 ED 一 司 © 
ERRAND, NEP) 四 ,sscm 
—TwEAg pes| @ xnnsns em pov) 
NaCl , Ed25519 , 或 大 RFC6979 OFBt 
共 中 的 EgDSAIF 要 A0ECDSA 用 了 暗 1 ORFC5979 且 好 入 于。 放 到 村 搞 DSA 人 ， 改 计 玉宇 作 从 忆 ) 下 非 对 生生 各 | © 
RswPxcstv15 Obes 
RSA 日 局 最 。 只 要 你 在 使 用 襄 列 茸 ,他 就 府 该 主 全 对称 宫 租 长 入 
ECDSA | FO Bun 2bntem8 
ZR | 
hy 蕊 六 teyep 四 法 
HUERTA DSAOECDSA 已 不 过 所 | 色色 个 加 守 关 法 职 生 加 相亲 使 用 ， 这 并 没什么 归 用 
和 0 果 作 在 计 加 0 宙 有 仿生 日 A 
“于 且 无 使用 国定 入 室友 
各 昌明 人 用， 吉本 用 ,不 要 要 ac 查 上 + 妈 。 四 NaC 全 日 二 归 。 安全 加 加 一 个 AP| ,各 普 位 开 改 APE9 油 用 方 认 还 
如 昌 闪 全 用 第 二 方 作 ,这 是 一 名 天 fa9ECDH 绑 ,有 主 窟 的 开导 代表 . 世 宙 度 好 安全 分 析 这 , 并 本 进入 TLS 1 3 版 本 标 半 HO 
@ ouss'o6 癌 二 也 | 要 便 用 一 个 蕴 2193 则 闻 行 于 t 划 法 ( 这 个 她 方 和 静 胡 的 蕴 识 完全 但， 请 务 乡 必 介 ) 
地 对 不 要 自己 天 疯 Curve25519 , 也 过 对 不 要 自己 趟 Curve2551969C 人 到 
On G| 2. 对称 ES | HMAC-SHA256, HMAC-SHAS12 竺 
orz20 本 部 中 9 Dme-Heiman 字 训 拱 ”| 行人 tt 的 二 于 和 Rhash 舍身 ， 作 的 设计 基本 部 显 有 安全 天 玖 四 
DH 窑 轴 顽 汪 ) 基于 溢 实 各 适用 , 但 号 它 各 全 要 
吉 果 一 十 要 从 反手 协商 ,或 和 扣 区 伯 互 玫 作 ,可 以 考虑 < ee 
rr hl 已 FREE SR 
现在 代 癌 时 的 DI-2048 介 玫 比 NISTP.256 更 妆 全 ，NIST P-256k 押 机 出 q9DH 更 家 全 
介 民 于 规 a9 DH_SRP_ 上 PAKE 本 理科 疝 J 二 
任何 只 便 用 了 块 加 密 贡 法 和 srand(me() 让 守 胡 汾 村 楼 式 ( 倚 定 存 渴 油 ) 了 EP” SHA2999 和 法 - SHA.256. SHA-334. SHA-512. SHA-5121256 
一 Sm | 
© Ly DD 不 | MD5 
Eee 方式 。 国 openssL Ga O| 10 RW 全 | moe 
@ wooemeomsst 二 256 bues 二 由 但 
不 司 见 的 TLS 关 ,0polarssl ,GnuTLS , MetrixSSt 等 不 直译 日 c[ 5 MD | 一 十 要 使 用 /evrandom , 汪 认 准 这 个 
AN 0 havaoed pos e0d 
稀 过 新村 公 咀 加 站 的 介绍 。 声 时 口 be 之 
The Loglam OH negotaton sc Me 
The FREAK expof cipher smack Or 
ee | se oun[ Ov 
Te CRIME cororestion sa 人 1 训 户 光 - 节 务 吉 后 构 的 应 用 入 序 的 安全 ”| qd (se 
本 |_ .wt | Ee 
这些 同 中 的 大 部 分 ， 仅仅 时 村 对 六 区 到 的 ; D Aas | RSHA1 
这 和 项 肌 二 的 大 部 分 , 期 区 部 可 /| 访 碱 径 , 只 入 要 他 在 代 芍 和 可 村 末 守 写 死 LS v12. ECDHE , 和 AES-_GCM 喜 行 ”| 仍 杀身 该 和 有 村 办 忆 WMDS 
不 要 日 己 人 t+? 加 frtxy 这 是 机 到 国 煌 用 异己 的 工 闪避 各 
bd 
不 要 全 用 承 几 中 于 
CE 


24.3 ”Nodejs 中 的 加 密 和 和 解密、 签名 和 认证 


网 


24-3 主 要 是 参考 官方 文档 及 一 些 其 他 文档 ( 见 24.5 节 中 给 出 的 链接 ) ， 按 照 笔者 个 人 的 理解 画 的 。 如 果 你 使 用 的 是 Nodejs， 那 么 基本 上 看 看 图 解 就 能 理解 和 应 用 了 。 特 别 是 ， 图 24-3 默 认 选 择 了 
ed25519 组 件 ， 如 果 你 看 了 图 24-1 和 图 24-2， 就 知道 这 是 签名 与 认证 的 最 好 选择 ， 因 此 这 里 可 以 肯定 地 说 ，Crypto 模 块 的 签名 与 认证 暂时 还 是 不 要 用 吧 。 亿 书 就 是 这 么 实践 的 。 另 一 个 是 Natrium 组 件 ， 也 
可 以 用 于 签名 和 认证 ， 但 主要 是 用 来 进行 非 对 称 加 密 和 解密 的 。 图 24-3 中 的 三 个 组 合 ， 按 照 上 面 的 实践 经 验 来 说 ， 应 该 是 当前 Nodejs 加 解密 应 用 领域 的 最 佳 组 合 方案 。 
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图 24-3 Node.js 平 台中 常用 密码 学 工具 


24.4 趣味 实践 


还 是 用 第 12 章 “加 密 和 验证 ”中 的 例子 ， 设 定 角色 ， 男 生 名 为 Bob， 他 的 女友 名 为 Alice。 


24.4.1 场景 


Bob 想 向 女友 Alice 表 达 埋 藏 已 久 的 心声 “| love you! ” ， 但 碍 于 颜面 (Bob 比较 羞涩) ， 不 好 意思 将 这 句 话 当面 说 出 口 ， 只 好 加 密 传输 给 Alice。 这 里 基于 一 个 可 行 的 假设 ， 那 就 是 他 们 已 经 拥有 彼此 
的 公 钥 ,或 者 可 以 简单 获得 。 


24.4.2 需求 


这 个 趣味 实践 中 的 需求 具体 如 下 。 


" 加 密 : 不 能 让 别人 看 到 信息 。 


Ey 


: 解密 : 女友 可 以 恢复 并 查看 。 
“签名: Bob 可 以 签名 信息 ， 并 确保 不 被 稀 改 。 


: 认证 : 女友 收 到 信息 ， 可 以 验 明 正身 ， 确 认 是 Bob 所 发 ， 而 不 是 别人 的 恶作剧 。 


24.4.3 方案 


利用 图 24-1 到 图 24-3 所 画 的 知识 点 ， 我 们 可 以 很 快 拿 出 技术 方案 。 


“ 加 密 与 解密 技术 : 本 案例 仅 提 供 思路 和 方法 ， 实 践 中 这 种 加 密 之 后 又 解密 原文 的 场景 并 不 多 见 。 从 图 24-2 可 以 看 出 ， 加 密 解 密 技术 最 好 是 使 用 NaCl， 其 次 是 libsodium (背后 仍然 是 NaCl) 。 但 是 ， 搜 
索 了 一 下 Github，Node.js 社 区 还 没有 相关 的 、 稳 定 的 NaCl 封 装 包 ，libsodium 倒 是 有 一 个 Natrium， 不 过 ， 笔 者 在 写作 本 章 时 ， 连 Nattium 的 安装 都 没 能 成 功 〈 如 果 有 读者 验证 成 功 ， 请 留言 或 联系 笔者 ) 。 因 
此 ， 只 能 选择 使 用 Crypto 进 行 简单 加 密 和 解密 了 。 


“ 签名 与 验证 技术 : 当然 最 好 的 选择 是 cd25519 了 。 
24.4.4 编码 


新 建 一 个 简单 的 Node.js 工 程 ， 源 代码 地 址 为 : https://github.com/imfly/node.js-practice/blob/master/crypto/index.js。 


1. 生 成 密 钥 对 


Bob 没 有 使 用 随机 字符 串 ， 而 是 使 用 了 一 个 密码 ， 并 采取 SHA256 算 法 生成 密 钥 对 ， 请 看 思维 导 图 中 有 关 Hash 的 部 分 。 代 码 如 下 : 


Var crypto = require('crypto'); 
Var ed25519 = require('ed25519'); 


Var bobsPassword = 'This is my password, you don't guess it!'; 
Var hash = crypto.createHash ('sha256') .update (bobsPassword) .digest (); 
Var bobKeypair = ed25519.MakeKeypair (hash); 


2. 给 信息 加 密 和 签名 


通常 是 先 加 密 后 签名 。 


这 里 使 用 Crypto 给 信息 进行 了 简单 加 密 ， 把 Bob 的 公 钥 作 为 加 密 键 值 (但 既然 是 公 钥 ， 那 么 我 们 全 都 会 知道 ， 除 非 Bbob 只 把 公 钥 给 了 Alice) ，Bob 可 能 还 得 告诉 Alice 应 该 使 用 什么 算法 来 解密 。 


Var message = 'Hi Alice, I love you!'; 
var msgCiphered = cipher('aes192'，bobKeypair.publicKey，message); ”// 公 钥 进行 加 密 ， 如 果 是 Natrium， 那 么 这 里 就 是 私 钥 加 密 
var signature = ed25519.Sign (new Buffer (msgCiphered,，'utf8'), bobKeypair.privateKey); // 私 钥 进行 签名 


3. 给 Alice 发 送 签名 信息 


发 送 签名 信息 的 渠道 有 很 多 ， 这 个 就 根据 具体 情况 具体 对 待 了 。 


4.Alice 验 证 并 解密 


通常 是 先 验 证 后 解密 。 作 为 Bob 的 好 朋友 ，Alice 有 他 的 公 钥 。 验 证 并 和 解密 的 过 程 如 下 : 


if (ed25519.Verify(new Buffer (msgCiphered, 'utf8'), signature, bobKeypair.publicKey)) { 
// 验证 函数 返回 了 true， 通 过 验证 
var msg = decipher ('aes192',，bobKeypair.publicKey，msgCiphered);  // 使 用 Bob 的 公 钥 解密 


console.1og (' 签 名 合法 ， 信 息 来 自 Bob! '); 
console.10g('Bob said: '，msg); // 显示 信息 
} else { 
// 验证 函数 返回 了 false， 肯 定 不 是 Bob 的 信息 
console.1og(' 签 名 不 合法 ! '); 


5. 补 充 代码 


上 面 用 到 的 是 Crypto 的 加 密 解密 方法 : 


// 加 密 

function (algorithm, key, buffer){ 
Var encrypted = ""; 
var cip = crypto.createCipher (algorithm, key); 
encrypted += cip.update (buffer, "utf8'， 'hex'); 
encrypted += cip.final ('hex'); 
return encrypted; 

} 


// 解密 

function decipher (algorithm, key, encrypted){ 
Var decrypted = ""; 
Var decipher = crypto.createDecipher (algorithm, key); 
decrypted += decipher.update (encrypted, 'hex', 'utf8'); 
decrypted += decipher.final ('utf8"'); 
return decrypted; 


6. 运 行 实例 


使 用 下 面 的 命令 ， 可 以 运行 上 述 代码 : 


$ git clone https:// github.com/imfly/node.js-practice 
$ cd node.js-practice 

$ npm install 

$ node crypto/ 


输出 结果 如 下 : 


签名 合法 ， 信 息 来 自 Bob! 
Bob said: Hi Alice, I love you! 


24.5 参考 


Ed25519 第 三 方 组 件 : https://github.com/dazoe/ed25519 
Ed25519 官 方 网 站 : http://ed25519.cr.yp.to/ 


《现代 密码 学 实践 指南 (2015 年 ) 》: http://blog.helong.info/blog/2015/06/05/modern-crypto/ 


《密码 学 一 小 时 必 知 》: http://blog.helong.info/blog/2015/04/12/translate-Everything-you-need-to-know-about-cryptgraphy-in-1-hour/ 


《 浅 谈 Node.js 中 的 Crypto 模 块 》: https://cnodejs.org/topic/504061d7fef591855112bab5 


第 25 章 “在 时 间 和 数据 计算 方面 应 该 注意 的 问题 


区 块 链 对 时 间 戳 和 数据 计算 方面 的 要 求 相对 较 高 ， 但 是 JavaScript 语 言 本 身 存在 先天 的 不 足 。 本 章 将 对 时 间 戳 和 数据 计算 这 两 个 问题 进行 深入 探讨 ， 提 醒 并 帮助 程序 员 在 开发 过 程 中 恰当 处 理 这 两 个 问 


25.1 ”时 间 截 处理 问题 


时 间 戳 是 很 多 应 用 系统 ， 特 别 是 区 块 链 开发 中 非常 重要 的 元 素 。 各 种 语言 都 提供 了 相应 的 时 间 处 理 函 数 ， 多 数 直接 拿 来 就 用 了 ， 没 发 现 有 什么 问题 。 但 是 在 时 间 处 理 问题 上 ， 开 发 语言 核心 模块 提供 的 
个 别 API 并 没有 完全 延续 人 类 的 习惯 。 在 Javascript 语 言 里 ， 有 一 个 Date 类 的 函数 就 非常 奇特 ， 网 络 上 很 多 文档 的 举例 都 是 错误 的 ， 因 此 在 这 里 需要 特别 说 明 一 下 。 


这 似乎 并 不 是 什么 大 问题 ， 但 是 从 stackoverflow.com 网 站 上 关于 时 间 处 理 的 问题 数量 及 受 关注 的 程度 来 看 ， 它 应 该 是 很 多 人 遇 到 的 普遍 问题 。 另 外 ， 万 一 还 有 更 多 “非常 规 ” 的 用 法 存在 ， 那 么 这 种 
看 似 很 小 的 问题 ， 可 能 就 是 致命 的 (逻辑 上 没 问 题 ， 意 识 中 没 发 现 ) 。 按 照 前 面 关于 异常 和 错误 的 处 理 要 求 ， 这 种 错误 应 该 是 程序 员 自 身 的 问题 了 ， 唯 一 的 解决 办 法 就 是 提高 能 力 ， 让 自己 更 加 严谨 、 更 加 
认真 。 所 以 ， 本 章 就 是 来 查 缺 补漏 的 ， 提 醒 大 家 不 要 在 这 个 小 问题 上 出 现 失误 。 


25.1.1 “问题 再 现 


请 猜想 下 面 的 语句 应 该 输出 哪 一 天 : 


new Date (Date.UTC (2005,7,8)); 


结果 是 : Mon Aug 08200508: 00: 00 GMT+0800 (中 国标 准时 间 ) ， 即 2005 年 8 月 8 日 。 


但 是 ， 看 看 网 上 这 篇 文档 的 解释 : http://www.w3school.com.cn/jsref/jsref_utc.asp， 作 者 始终 是 按照 2005 年 7 月 8 日 来 设计 的 。 


其 实 ， 网 上 还 有 很 多 文档 都 犯 了 这 个 错误 。 笔 者 本 人 也 是 因为 反复 没有 获得 想 要 的 结果 ， 然 后 着 手 查 询 文 档 ， 才 发 现 这 个 错误 的 。 


25.1.2 “时间 惟 的 重要 性 


时 间 戳 (timestamp) 通常 是 一 个 字符 序列 ， 唯 一 地 标识 了 某 一 刻 的 时 间 ， 指 的 是 格林 威 治 时 间 1970 年 01 月 01 日 00 时 00 分 00 秒 (北京 时 间 1970 年 01 月 01 日 08 时 00 分 00 秒 ) 起 至 现在 的 总 毫秒 数 。 我 
国有 国家 授时 中 心 ， 因 其 守 时 监测 功能 而 保障 时 间 戳 证 书 中 时 间 的 准确 性 和 不 被 自 改 ， 具 有 法 律 效 力 。 


图 


2008 年 11 月 25 日 ， 深 圳 市 龙岗 区 法 院 公开 宣判 知识 产权 纠纷 案 ， 其 中 “ 利 龙 湖 ” 一 案 系 


内 首 例 时 间 戳 技术 司法 应 用 案例 ， 宣 判 后 双方 当事人 均 未 提起 上 诉 ， 该 案 判决 书 已 经 产生 法 律 效力 。 


从 技术 上 讲 ， 时 间 戳 可 以 理解 为 数据 写 入 或 修改 时 的 时 间 点 ， 使 用 毫秒 表示 ， 是 一 项 数据 存在 性 证 明 (Proof of Existence) 的 唯一 有 效 参数 。 加 密 货币 将 时 间 戳 作为 重要 字段 信息 ， 每 笔 交 易 、 每 个 区 
块 都 要 记录 时 间 戳 。 对 于 亿 书 而 言 ， 时 间 戳 更 是 版 权 信息 中 一 个 不 可 或 缺 的 元 素 。 


25.1.3， 不 同 产品 对 时 间 处 理 的 需求 


笔者 经 常 思考 这 样 一 个 问题 : 作为 加 密 货 币 ， 亿 书 的 每 笔 交 易 都 有 时 间 戳 ， 而 且 对 于 版 权 保护 ， 时 间 戳 还 是 非常 重要 的 字段 。 如 果 亿 书 的 一 个 节点 在 国内 ， 另 一 个 节点 在 美国 ， 那 么 这 个 时 间 处 理 该 如 
何 统一 ”相关 的 方法 又 该 如 何 选择 ? 


从 理论 上 分 析 ， 不 同 的 产品 对 时 间 处 理 的 需求 可 能 也 不 相同 。 


1) 对 于 一 般 的 应 用 系统 ， 特 别 是 没有 国际 化 要 求 的 产品 ， 时 间 上 自然 没有 特殊 要 求 ， 前 端 后 台 统一 是 很 简单 的 事 ， 只 要 避免 出 现 上 面 的 失误 ， 正 确 使 用 时 间 相 关 的 接口 函数 即 可 。 


2) 对 于 有 国际 化 需求 的 产品 ， 特 别 是 加 密 货币 这 种 去 中 心 化 的 产品 ， 全 世界 的 用 户 都 在 使 用 ， 那 就 要 考虑 如 下 两 个 方面 的 因素 ， 一 个 是 面向 用 户 的 时 间 本 地 化 问题 ， 另 一 个 是 面向 产品 后 台 的 时 间 统 一 
性 问题 。 


25.1.4 ”时 间 处 理 的 基本 原理 


全 球 人 的 时 间 都 是 一 样 的 。 但 是 ， 相 同时 刻 ， 不 同时 区 的 人 们 ， 所 处 的 时 空 是 不 一 样 的 。 不 同时 区 的 人 们 对 于 时 空 的 感受 又 是 那么 惊人 的 相似 ， 比 如 : 除了 南北 极 ， 大 多 数 地 方 都 是 早上 五 六 点 钟 太阳 
升 起 ， 中 午 十 二 点 左右 艳阳 高 照 ， 下 午 五 六 点 钟 日 落 西山 ， 如 果 一 个 中 国人 去 了 美国 〈 比 国内 时 间 晚 13 个 小 时 ) ， 当 地 是 中 午 艳 阳 高 照 ， 一 看 手表 ， 竟 然 是 午夜 0 点 钟 ， 一 时 间 会 难以 调整 时 间 概 念 ， 因 此 
为 了 迎合 人 类 的 习惯 ， 自 然 就 有 了 很 多 的 本 地 化 需求 。 


从 编程 的 角度 来 看 ， 时 间 具 备 唯一 、 均 匀 和 恒定 的 特点 ， 只 要 使 用 统一 确定 的 参考 点 ， 就 不 至 于 在 系统 中 出 现 混乱 。 所 以 ， 对 应 上 面 的 产品 需求 ， 对 于 不 需要 国际 化 的 产品 ， 只 要 使 用 本 地 化 时 间 处 理 
的 方法 即 可 (参考 点 是 本 地 ) ， 前 后 端 统一 ， 罗 辑 简单 。 而 对 于 国际 化 的 产品 ， 那 就 要 使 用 世界 统一 时 间 (参考 点 是 国际 日 期 变更 线 ，UTC 或 GMT 标 准时 间 ) ， 然 后 在 客户 端面 向 用 户 进行 本 地 化 处 理 即 
可 。 


25.1.5 JavaScript 语 言 的 Date 对 象 


JavaScript 提 供 了 操作 日 期 和 时 间 的 对 象 Date。Date 对 象 是 JavaScript 语 言 中 的 一 种 内 部 数据 类 型 (类 函数 ) ， 可 使 用 语法 new Date () 进行 创建 。 创 建 了 对 象 之 后 ， 就 可 以 使 用 多 种 方法 来 操作 它 
了 。 下 面 列 出 几 个 需要 熟练 掌握 的 细节 供 大 家 参考 。 


new Date () 

new Date (milliseconds); 

new Date (dateString); 

new Date (year, month[, day[, hour[, minutes[, seconds[, milliseconds]]]]]); 


简单 概括 为 一 句 话 : 新 建 对 象 可 以 使 用 0 ~ 7 个 参数 ， 这 些 参数 可 以 是 字符 串 或 数字 。 


2 参数 


关于 参数 需要 注意 如 下 


hn 
ul 


项 。 
Date 时 刻 面向 本 地 时 间 ， 参 数 代 表 的 是 本 地 时 间 ， 新 建 的 对 象 代表 的 也 是 本 地 时 间 ， 输 出 的 结果 后 面 通 常 有 (某国 标准 时 间 ) 等 字样 。 
“0 个 参数 ， 生 成 的 是 当前 日 期 和 时 间 。 


“ 1 个 参数 ， 若 是 数字 milliseconds， 则 应 该 是 距离 1970 年 1 月 1 日 午夜 《UTC) 的 毫秒 数 ， 通 常 使 用 Date.UTC () 函数 来 设 定 ; 若是 字符 串 dateStting， 则 应 该 是 时 间 格 式 ， 如 : new Date ("December 


17，199503: 24: 009 。 


“2~7 个 参数 ， 只 能 是 数字 。 只 有 day 是 从 1 开始 ， 其 他 都 是 从 0 开始 的 。 因 为 周期 通常 采取 取 模 运算 ， 所 以 如 果 数 值 大 于 合理 范围 (如 月 份 为 13) ， 数 值 会 被 自动 调整 。 比 如 : new Date (2013，13，1) 
即 等 于 new Date (2014，1，1) ， 它 们 都 表示 日 期 2014-02-01 (注意 : 月 份 是 从 0 开始 的 ) 。 


“如果 需要 使 用 世界 统一 时 间 ， 那 么 就 要 使 用 new Date (Date.UTC (http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/16329/OEBPS/Text/.…) ) 和 相同 的 参 


数 。 


3 方法 


“ 静态 方法 : 3 个 ， 都 将 返回 距离 标准 时 间 的 毫秒 数 ， 分 别 对 应 构建 函数 的 三 种 形式 ， 其 中 包括 Date.now () 、Date.parse () (解析 一 个 表示 日 期 的 字符 串 ) 、Date.UTC () (2~7 个 参数 ) 。 
“ 实例 方法 : 4 种 ，get 类 查询 方法 、set 类 设置 方法 、to 类 转换 方法 和 of 类 ， 其 中 每 种 方法 都 提供 了 本 地 和 世界 统一 时 间 两 个 参考 系 的 方法 ， 比 如 get[UTC]Date () 方法 。 


特别 注意 的 是 : getTime () 方法 不 分 时 区 ， 返 回 的 是 Date 对 象 的 内 部 毫秒 表示 ， 这 将 是 去 伪 存 真 的 唯一 途径 ， 比 如 ， 要 判断 不 同时 区 是 否 同时 ， 仅 仅 看 这 个 方法 的 返回 值 就 可 以 了 ， 应 该 说 在 世界 上 不 
同 的 时 区 ， 同 时 运行 (new Date () ) .getTime () 的 返回 值 是 一 样 的 。 


25.1.6 ”实践 


编程 里 需要 处 理 的 问题 ， 无 非 是 如 下 这 样 几 个 场景 (下 面 的 代码 均 来 自 官方 文档 和 亿 书 源码 ) 。 


1. 记 录 时 间 


var today = new Date(); // 本 地 当前 日 期 和 时 间 
var birthday = new Date ("1995-12-17T03:24:00"); // 1995 年 12 月 17 日 
var birthday = new Date (1995,11,17); // 1995 年 12 月 17 日 


如 果 需 要 格式 化 ， 那 么 可 以 使 用 上 面 提 到 的 to 为 前 缀 的 转换 方法 ,例如 toLocaleDate-String () 、toLocaleString () 等 。 如 果 不 满意 ， 就 找 找 现成 的 扩展 插件 ， 比 如 momentjs。 如 果 仍 不 满意 ， 那 
就 自己 实现 吧 ， 其 实 自己 定制 也 很 简单 。 


2. 计 算 时 间 


主要 原则 是 先 计算 距离 标准 时 间 的 毫秒 数 ， 然 后 再 计算 时 间 。 因 为 这 类 方法 本 身 就 是 基于 世界 统一 时 间 (UTC) 的 ， 并 且 在 计算 过 程 中 可 能 还 会 使 用 减法 来 处 理 时 间 段 ( 差 值 ) ， 因 此 参考 点 抵消 ， 可 
以 不 去 考虑 参考 点 的 存在 。 


计算 时 间 被 大 量 应 用 到 项 目 中 ， 也 有 很 多 第 三 方 包 的 存在 ， 比 如 timeagojs 之 类 的 ， 下 面 就 来 简单 举例 说 明 。 


1) 在 浏览 器 上 推荐 使 用 Date 对 象 : 


Var start = Date.now(); 


// 这 里 进行 耗 时 的 方法 调用 : 
doSomethingForALongTime () 7 

var end = Date.now() 

var elapsed = end - start; // 运行 时 间 的 毫秒 值 


为 了 兼容 IE8 及 之 前 版 本 的 浏览 器 ， 可 以 进行 如 下 处 理 : 


if (!Date.now) { 
Date.now = function() { return new Date () .getTime(); } 


bs 


2) 在 Nodejs 等 环境 下 ， 建 议 使 用 内 建 的 getTime () 方法 : 


// 设置 初始 时 间 
var begin = Date.UTC(2016，6，14，0，0，0，0); // 2016 年 7 月 1 日 ， 月 份 从 0 开始 


// 获得 当前 时 间 
Var now = new Date () 7 
var elapsed = now.getTime () - begin.getTime () ; // 毫秒 值 


3) 为 了 获得 以 秒 为 单位 的 时 间 戳 ， 建 议 使 用 : 


Math.floor (Date.now() / 1000) 


25.2 ”数据 计算 处 理 问 题 


25.2.1 ”问题 再 现 


1. 最 好 不 用 parselnt () 


不 要 将 parselnt 当 作 转 换 Number 和 Integer 的 工具 。 


问题 


将 小 于 0.0000001 (1e-7) 的 数字 转换 成 String 时 ，JavaScript 默 认 会 将 其 变 成 科学 记 数 法 ， 这 时 若 再 对 这 个 数字 进行 parselnt 操 作 就 会 导致 问题 的 发 生 。 即 : 


parseInt (0.0000008) === 8 


解析 


常见 的 问题 有 浮 点 数 比 较 : 


console.log((0.1 + 0.2) 一 0.3); // false 
console.log((0.1 + 0.2) 一 -= 0.3); // false 
console.1log(0.1 + 0.2); // 0.30000000000000004 


再 有 : 


parseInt (1000000000000000000000.5, 10); // 1 


parselnt 的 第 一 个 类 型 是 字符 串 ， 所 以 会 将 传 入 的 参数 转换 成 字符 串 ， 即 String (1000000000000000000000.5) 的 结果 为 le+21。parselnt 并 没有 将 “e” 视 为 一 个 数字 ， 所 以 在 转换 到 e 的 时 候 就 停 


直 了 7s 


这 也 就 可 以 解释 为 什么 parselnt (0.0000008) ===8: 


String(0.000008); // '0.000008 
String(0.0000008); // '8e-7' 


参考 : http://www.tuicool.com/articles/7nMbea 


2. 对 于 大 数据 ，JavaScript 有 限制 
(1) 问题 


第 三 方 API 提 供 的 数据 : 


{"content": "Hi"，"created at": 1340863646, "type": "text", "message id": 5758965507965321234, "from user": "userC"} 


其 中 message id 是 19 位 number 类 型 的 ， 可 以 使 用 JSON.parse 解 析 成 JSON 对 象 并 获取 其 中 的 信息 ， 方 法 如 下 : 


Var jsonStr = '{"content": "Hi", "created at": 1340863646, "type": "text", "message id": 5758965507965321234, "from user": "userC"}'; 


Var jsonObj = JSON.parse (jsonstr); 
console.10g (jsonObj .message_id) ;// 得 到 结果 是 : 5758965507965321000 


所 得 到 结果 的 最 后 三 位 变 成 了 000。 超 过 16 位 的 数据 解析 后 均 会 变 为 000。 
(2) 解析 


浮 点 数 范围 : 


最 大 +1.7976931348623157 x 10 的 308 次 方 
最 小 +5 x 10 的 -324 次 方 


精确 整数 范围 : 


-9007199254740992 ”~ 9007199254740992 〈 即 正 负 2 的 53 次 方 ) 


数组 索引 还 有 位 操作 : 


正 负 2 的 31 次 方 


(3) 参考 
https://cnodejs.org/topic/4ff679c84764b7290214460a 


https://cnodejs.org/topic/4fb3722c1975fele132b5a9a 


25.2.2 ”终极 答案 


使 用 node-bignum 即 可 解决 ， 源 码 地 址 为 https://github.com/Ebookcoin/node-bignum。 


区 出 现 了 很 多 bignumber 包 ， 但 只 有 node-bignum 可 以 完美 解决 上 述 问题 ， 诸 如 bignumberjs 等 第 三 方 包 无 法 解决 小 数 问题 。 


Ea 


25.3 参考 


国际 日 期 变更 线 : http://baike.baidu.com/link? url=KXEt7IGgVrZzmHTpJbDXFHfeJ402S7XCmHZIiO9EFhAZOMWCaaWoOclTFxIHK--MOIlZdkLBWvzar7atrtUG9Js-Xq 


时 间 戳 : http://baike.baidu.com/link? url=6yhlQcDZiX7HkhM3o2CSkEjM-wOQ-M-X74kjsj-5zq3Dxm2FQHXvel-ox7kGSSY94hRgziOIAmCW5T2go9s TE_ 
《Javascript 标 准 库 Date 文 档 》: https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global ObjectsDate 


《How do you get a timestamp in JavaScript? 》: http://stackoverflow.com/questions/221294/how-do-you-get-a-timestamp-in-javascript 


第 26 章 测试 


测试 与 开发 相辅相成 ， 一 个 完整 的 项 目 是 离 不 开 测 试 的 ， 测 试 可 以 保证 系统 的 正确 运行 。 在 当下 的 开发 实践 中 ， 测 试 驱 动 开发 是 增 量 开发 的 基础 ， 是 保证 项 目 特别 是 大 型 项 目 健康 发 展 的 根本 手段 。 本 
章 从 介绍 基本 概念 和 流程 入 手 ， 重 点 介绍 Nodejs 下 常用 的 测试 框架 mocha、should 和 一 些 基本 的 测试 方法 。 


26.1 概念 解释 


1. 单 元 测试 


在 计算 机 编程 中 ， 单 元 测试 (又 称 为 模块 测试 ，Unit Testing，UT) 是 针对 软件 设计 的 最 小 单元 程序 模块 ) 进行 的 正确 性 检验 的 测试 工作 。 程 序 单元 是 应 用 的 最 小 可 测试 部 件 。 在 过 程 化 编程 中 ,一 
个 单元 就 是 单个 程序 、 函 数 、 过 程 等 对 于 面向 对 象 编程 ， 一 个 单元 就 是 方法 ， 包 括 基 类 ( 超 类 ) 、 抽 象 类 ， 或 者 派生 类 ( 子 类 ) 中 的 方法 。 


2. 集 成 测试 


整合 测试 又 称 组 装 测试 ， 即 将 程序 模块 采用 一 次 性 或 增殖 方式 组 装 起 来 ， 对 系统 的 接口 进行 正确 性 检验 的 测试 工作 。 整 合 测试 一 般 在 单元 测试 之 后 、 系 统 测试 之 前 进行 。 实 践 表 明 ， 虽 然 模 块 有 时 可 以 
单独 工作 ， 但 是 并 不 能 保证 组 装 起 来 也 可 以 工作 。 


3. 系 统 测试 


系统 测试 是 将 需要 测试 的 软件 ， 作 为 基于 计算 机 系统 的 整个 元 素 ， 与 计算 机 硬件 、 外 设 、 某 些 支持 软件 、 数 据 和 人 员 等 其 他 系统 元 素 及 环境 结合 在 一 起 进行 测试 。 在 实际 运行 (使 用 ) 环境 下 ， 对 计算 
机 系统 进行 一 系列 的 组 装 测试 和 确认 测试 。 系 统 测试 的 目的 在 于 通过 与 系统 的 需求 定义 做 比较 ， 发 现 软件 与 系统 定义 不 符合 或 与 之 矛盾 的 地 方 。 


4. 性 能 测试 


性 能 测试 是 对 软件 性 能 进行 评价 。 简 单 地 说 ， 软 件 性 能 衡量 的 是 软件 所 具有 的 响应 及 时 度 能 力 。 因 此 ， 性 能 测试 是 采用 测试 的 手段 对 软件 的 响应 及 时 性 进行 评价 的 一 种 方式 。 根 据 软件 的 不 同类 型 ， 性 
能 测试 的 侧重 点 也 有 所 不 同 。 


5.benchmarking 


基准 测试 是 一 种 测量 和 评估 软件 性 能 指标 的 方法 ， 具 体 做 法 是 ， 在 系统 上 运行 一 系列 的 测试 程序 并 把 性 能 计数 器 的 结果 保存 起 来 ， 这 些 结果 称 为 “性 能 指标 ”。 性 能 指标 通常 都 会 被 保存 或 归档 ， 并 在 
系统 环境 的 描述 中 进行 注解 。 这 可 以 让 它们 对 系统 过 去 和 现在 的 性 能 表现 进行 对 照 和 比较 ， 从 而 确认 系统 或 环境 的 所 有 变化 。 


6 行为 驱动 开发 (BDD) 


BDD 的 英文 全 称 是 Behavior-Driven Development， 即 行为 驱动 开发 。 它 通过 使 用 自然 语言 书写 的 、 非 程序 员 可 读 的 测试 用 例 来 扩展 测试 驱动 开发 的 方法 。 行 为 驱动 开发 人 员 混 合 使 用 自然 语言 来 描述 
他 们 的 代码 。 这 样 做 可 以 让 开发 者 将 精力 集中 在 代码 应 该 怎么 写 ， 而 不 是 技术 细节 上 ， 也 能 最 大 程度 地 减少 将 代码 编写 者 的 技术 语言 与 商业 客户 、 用 户 、 利 益 相关 者 、 项 目 管理 者 等 各 个 领域 的 特定 语言 进 
行 来 回 翻译 的 代价 。 


26.2 ”框架 流程 


， 在 不 同 的 阶段 对 应 了 不 同 的 测试 方法 ， 如 图 26-1 所 示 。 


根据 上 面 的 概念 ， 笔 者 按照 测试 的 顺序 制作 了 一 个 流程 


[ 


单元 测试 


Mocha.. should 


图 26-1 测试 流程 示意 图 


26.3 ”测试 框架 与 库 介绍 


1 .测试 框架 Mocha 


Mocha 是 一 个 简单 、 灵 活 、 有 趣 的 JavaScript 测 试 框架 ， 用 于 Nodejs 和 浏览 器 上 的 Javascript 应 用 测试 ， 大 多 数 Nodejs 开 发 者 都 在 使 用 ， 所 以 还 是 很 可 靠 的 。 
2. 断 言 库 should.js 
shouldjs 也 支持 浏览 器 和 Node.js 环 境 ， 它 的 特色 就 是 书写 起 来 更 像 人 类 语言 ， 错 误 提示 也 是 表达 期 望 应 该 是 什么 样 的 (正如 它 的 名 字 ) 。 


3.Web 测 试 库 supertest 


基于 Super-agent 的 HTTP 接 口 测试 库 ， 提 供 了 更 高 抽象 的 方法 ， 使 得 测试 HTTP 服 务 更 加 顺 滑 ， 也 支持 调用 superagent 的 接口 方法 。 


4. 基 准 库 benchmark 


benchmark 也 是 一 个 可 以 用 于 Node.js 和 浏览 器 上 的 JavaScript 的 基准 测试 库 。 


26.4 ”实践 


安装 使 用 ， 代 码 如 下 : 


npm install mocha -9 

npm install should --save-dev 
npm install supertest --save-dev 
npm install benchmark --save-dev 
mkdir test 

atom test/test.js 


WDD 


Atom 是 可 视 化 编辑 器 ， 你 也 可 以 使 用 其 他 的 IDE 打 开 并 编辑 test.js 文 件 。 


1. 简 单 例子 


下 面 使 用 官方 提供 的 例子 ， 验 证 数组 的 indexOf 方 法 越界 后 是 否 返 回 -1， 这 个 例子 使 用 了 Node.js 自 带 的 断言 模块 assert: 


Var assert = require('assert'); 
describe('Array', function() { 
describe('#indexOof ()', function() { 
it('should return -1 when the value is not present', function() { 
assert.equal (-1, [1,2,3] .indexOf (4)); 
js 
}); 
])3 


“describe () : 传 进去 的 字符 串 可 用 来 描述 要 测试 的 主体 是 什么 ， 可 以 嵌 套 ， 这 里 要 测试 的 主体 就 是 Array，indexOf 方 法 是 其 中 的 一 个 子 描述 。 


“it () : 描述 具体 的 case 内 容 ， 里 面包 含 了 断言 的 使 用 。 


执行 后 输出 如 下 : 


$ mocha test.js 
Array 


#indexOf () 
YN should return -1 when the value is not present 


1 passing (l8ms) 


上 面 所 示 的 代码 是 passing (通过 测试 ) 的 结果 ， 下 面 再 来 看 看 failing (没有 通过 测试 ) 的 情况 ， 把 断言 中 的 -1 改 为 0， 执 行 后 可 以 看 到 : 


$ mocha test.js 


Array 
#indexof () 
1) should return 0 when the value is not present 


0 passing (l8ms) 
1 failing 


1) Array #indexOf () should return 0 when the value is not present: 


AssertionError: = -1 
+ expected - actual 


= 
wel 


at Context.<anonymous> (test.js:5:14) 


定位 错误 的 信息 都 打印 出 来 了 ， 通 过 这 个 简单 的 例子 ， 我 们 可 以 知道 应 该 


2. 异 步 


回 


调 测试 


回 


将 修改 刚才 的 代码 ， 加 入 延 时 执行 ， 修 改 如 下 : 


Var assert = require('assert'); 
Var async = function (callback) { 
setTimeout (function () { 
callback (assert.equal (-1, [1,2,3] .indexOf (4))); 
}, 10); 
}; 
describe('Array', function() { 
describe ('#indexOf ()', function() { 


it('should return -1 when the value is not present', function (done) 


async (function (result) { 
done (result); 
]); 


回调 是 JavaScript 里 最 基础 的 函数 调用 方式 ， 写 异步 测试 案例 时 只 需 


怎样 


describe 和 it 来 描述 测试 用 例 ， 接 下 来 将 要 介绍 一 些 常见 的 测试 类 型 。 


在 it () 中 添加 一 个 回调 函数 (通常 是 done) ， 这 个 回调 函数 接受 一 个 error 做 参数 ， 如 果 传 回 


参数 error 就 表示 失败 了 ， 那 么 我 们 


关于 这 个 例子 输出 的 结果 ， 这 里 就 不 给 出 图 了 ， 大 家 可 以 自行 试验 (assert 失 败 会 返回 AssertionError) 。 


3.Promise 测 试 


Promise 是 目前 ES6 规 范 里 比较 流行 的 异步 测试 方式 了 ， 对 Promise 的 测试 支持 也 变 得 很 如 


要 ，mocha 支 持 直接 返回 Promise， 执 行 resolve 是 测试 成 功 ， 执 行 reject 则 是 测试 失败 : 


Var assert = require('assert'); 

Var promise = new Promise (function (resolve, reject){ 
const result = [1,2,3].indexOf (4) 
if (result == 0) { 

resolve (true) 
elself 

reject (false) 
} 

}) 

describe('Array', function() { 
describe ('#indexOf ()', function() { 


it('should return -1 when the value is not present', function () 


return promise 


}); 
}); 
]); 


4.should.js 使 


上 面 的 例子 都 是 一 些 基本 的 判断 ， 如 果 要 判断 更 复杂 的 情况 ， 你 需要 自己 写 很 多 代码 ， 那 么 should 就 能 让 这 些 变 得 简单 实用 ， 使 


false 了 。 比 如 可 以 判断 一 个 对 象 是 否 有 这 个 属性 ， 判 断 类 型 是 否 为 字符 串 或 数组 ， 还 有 很 多 用 法 ， 可 以 去 官网 文档 里 查看 http://shouldjs.github.io/#should。 


should 库 可 以 为 对 象 加 上 更 多 方法 ， 而 不 用 自己 来 实现 和 判断 true 和 


Var assert 
var should 


= require('assert'); 
= require('should'); 
describe('Should', function() { 
it('should have property a ', function () { 
({ a: 10 }) .should.have.ownProperty('a'); 
}); 
D); 


比较 好 的 地 方 还 在 于 should 支 持 Promise， 可 以 判断 Promise 的 结果 : 


Var should = require('should'); 


describe('Should', function() { 
it('should return 10 ', function () { 


]); 
])3 


return new Promise ( (resolve, reject) => resolve (10) ) .should.be.finally.equal(10) ; 


5.Web 接 口 测试 


此 例子 参照 亿 书 的 testylib/accounts,js 的 代码 ，supertest 可 以 直接 调用 superagent 的 接口 ， 除 此 之 外 还 新 增 了 expect 接 口 ， 可 以 验证 status、header 和 body， 以 及 在 end 函 数 里 直接 处 理 返 回 的 数 
据 。 具 体 接口 说 明 可 以 直接 查看 官方 文档 ，26.6 节 给 出 了 相关 链接 。 


var request = require('supertest'); 
Var should = require('should'); 


describe('Account', function() { 
it('Opening account with password: password. Expecting Success', function (done){ 
request ('http:// 127.0.0.1:7000') .post ('/accounts/open') 

‘Set ('Accept', 'application/json') 

.send({ 
secret: 'password' 

}) 

.expect ('Content-Type', /json/) 

.expect (200) 

.end (function (err, res){ 
if (err) done (err); 
res.body.should.have.property ('success', true); 
res.body.should.have.property ('account') .which.is.Object (); 
res.body.account .address.should.equal ('12099044743111170367C'); 
res.body.account .publicKey.should.equal ('fbd20d4975e53916488791477dd38274clb4ec23ad322a65adb171lec2ab6a0dc'); 
done (); 


可 通过 supertest 设 置 请 求 路 径 和 参数 ， 对 返回 的 response 的 status 进 行 判断 ， 并 且 直 接 通 过 end 函 数 处 理 返回 的 内 容 ， 通 过 刚才 的 should 库 对 pody 的 属性 进行 检验 ， 最 后 调用 done 结 束 。 这 个 过 程 就 
是 亿 书 中 最 常用 的 接口 测试 ， 更 多 例子 可 以 去 查看 亿 书 的 测试 源码 。 


6. 性 能 测试 


在 上 面 的 例子 中 ， 可 以 使 用 Nodejs 自 带 的 consloetime 输 出 耗费 时 间 ， 但 是 ， 如 果 是 有 比较 性 的 测试 ， 比 如 需要 知道 哪个 方案 运行 得 更 快 ， 这 时 就 需要 benchmark 库 了 ， 下 面 就 参照 官方 文档 的 例子 
讲解 一 下 : 


Var suite = new Benchmark.Suite; 


// add tests 

suite.add ('RegExp#test', function() { 
/o/.test('Hello World!'); 

}) 

.add('String#indexOf', function() { 
'Hello World!'.indexOf('o0') > -1; 


}) 

// add listeners 

.on('cycle', function(event) { 
console.1og (String (event .target)); 


on('complete', function() { 
console.log('Fastest is ' + this.filter('fastest') .map('name')); 
}) 
// run async 
.run({ 'async': true }); 


执行 的 结果 如 下 : 


RegExp#test x 5,658,069 ops/sec +1.61% (78 runs sampled) 
String#indexOf x 10,170,498 ops/sec +1.40% (78 runs sampled) 
Fastest is String#indexOf 


这 个 例子 使 用 了 两 种 方法 (正则 和 查找 索引 ) 来 判断 一 个 字符 串 是 否 含有 “o” ， 其 中 ，ops/sec 测 试 结 果 显 示 的 是 每 秒 钟 执行 测试 代码 的 次 数 (ops/sec) ， 这 个 数值 越 大 越 好 。 除 了 这 个 结果 之 外 ， 
同时 还 会 显示 测试 过 程 中 的 统计 误差 。 


26.5 总结 


VGN= 口 


本 章 主要 讲述 了 测试 的 一 些 简单 做 法 和 示例 ， 适 合 初学 者 入 门 使 用 ， 目 的 是 让 开发 人 员 了 解 Nodejjs 的 常用 测试 方法 。 测 试 是 一 门 很 重要 的 学 问 ， 关 于 测试 的 理论 和 实践 ， 已 经 有 很 多 人 做 过 总 结 ， 笔 者 
水 平 有 限 ， 同 时 限于 文章 篇 幅 ， 未 能 详细 讲述 ， 如 果 您 是 专业 的 测试 人 员 ， 或 者 您 还 需要 对 测试 有 更 深入 的 了 解 ， 那 么 建议 阅读 一 些 关 于 软件 测试 和 质量 控制 的 专业 图 书 。 


26.6 参考 


软件 测试 : https://zh.wikipedia.org/wiki/ 软 件 测试 
Mocha: https://github.com/mochajs/mocha 

Should: https://github.com/shouldjs/should.js 
supertest: https://github.com/visionmedia/supertest 
superagent: https://github.com/visionmedia/superagent 


BDD: https://zh.wikipedia.org/wiki/ 行 为 驱动 开发 


第 五 部 分 ”附录 


附录 A ”区 块 链 相关 术语 


说 明 : 阅读 英文 文档 是 编程 开发 过 程 中 


做 的 一 件 事 ， 英 文 阅 读 也 是 一 个 程序 员 的 基本 能 力 。 


最 常 
内 容 。 该 帖子 仍 在 持续 更 新 中 ， 更 多 新 内 容 请 参照 下 面 的 地 址 阅读 原 帖 。 


原文 标题 : 《数字 货币 翻译 术语 (中 英 对 照 ) 》 


原文 地 址 : http://8btc.com/thread-17286-16-1.html 


本 文 已 经 征 得 原作 者 同意 ， 版 权 归 巴 比 特 论 坛 ， 在 此 感谢 社 
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快速 中 继 网 络 
快速 区 块 中 继 协 议 
向 前 纠 错 

现场 可 编程 门 阵列 (FPGA) 
金融 脱 媒 

金融 技术 
分 叉 攻击 

分 又 

欺诈 证 明 


生成 

区 块 创始 交易 

生成 点 

创始 区 块 

GetBlockTemplate (GBT) 挖 矿 协 议 
获取 SPV 节点 

GetWork (GWK) 控 矿 协议 

图 形 处 理 单 元 (GPUs ) 

全 域 唯一 识别 元 


黑客 
减 半 


English 
hardware wallets 
hard fork 
hard limit 
hash 
Hardware Security Modules (HSM) 
hashing powerand 
hashcash algorithm 
HD wallet system 
header hash 
heavyweight wallet 
Hierarchy Deterministic (HD) 
honesty 
hyperledger 


human readable format 


identifiers 

immutability of blockchai 
implementing in Python 
in block header 
independent verificatio 
innovation 

inputs 

Internet of Things 
instamine 

Invertible Bloom Lookup Table (IBLT) 
invalid numerical value 


InterPlanetary DataBase (IPDB) 


K 
key formats 
key-value 
Know Your Customer (KYC) 
Ls 


LevelDB database (Google) 
light weight 

linking blocks to… 

linking to blockchain 
Lightning Network (LN) 


linear scale 


中 文 
硬件 钱包 
人 硬 分 义 
人 硬 限制 
散 列 值 
硬件 安全 模块 
散 列 算 力 
散 列 现金 算法 
分 层 确 定性 钱包 系统 
头 部 散 列 值 
重量 级 钱包 
分 层 确 定 的 
诚信 算 力 
超级 账本 
人 类 可 读 模 式 


标识 符 

区 块 链 不 可 更 改 性 
由 Python 实现 

在 区 块 的 头 部 
独立 验证 

创新 

输入 

物 联网 

偷 控 

可 逆 式 布 鲁 姆 查找 表 
无 效 数 值 

星际 数据 库 


密 钥 格 式 
键 值 
了 解 你 的 客户 


LevelDB 数据 库 (Google) 
轻 量 级 

将 区 块 连接 至 … 

连接 至 区 块 链 

闪电 网 络 

线性 尺度 


English 
Litecoin 
lock time 
locking Scripts 
log scale 
M 
mainnet 


managed pools 

mastercoin protocol 
masternode 

memorypool (mempool) 
Merkle tree (Merkle Hash tree) 
Merkle root 

metachains 

mining 

mining blocks successfully 
mining pools 

mining rigs 

micropayment 

microblocks 

modifying private key formats 
monetary parameter alternatives 
Moore s Law 

Moonpledge 

MPC 

multi account structure 
multi-hop network 
multi-signature 
multi-signature addresse 
multi-signature scripts 


multi-signatureaccount 


Namecoin 

native token 

navigating 

Network Propagation 
Network of marketplaces 
Nextcoin (NXT) 
Neoscrypt 


( 续 ) 


中 文 
莱特 币 
锁定 时 间 
锁定 脚本 
对 数 单位 


主 网 

万 事 达 币 协议 
主 节点 

内 存 池 

二 进 制 的 散 列 树 或 二 又 散 列 树 ， 也 称 为 “ 默 克 尔 树 ” 
二 进 制 散 列 树 根 
附 生 块 链 

挖 矿 

成 功 产 ( 挖 ) 出 区 块 
矿 池 

矿 机 

小 额 支 付 

微 区 块 
修改 密 钥 格式 
货币 参数 替代 物 
摩尔 定律 

月 球 之 拆 

多 方 计 算 

多 重 账户 结构 
多 跳 网 络 

多 重 签名 

多 重 签名 地 址 
多 重 签名 脚本 
多 重 签名 账户 


域名 币 (基于 比特 币 技术 的 分 布 式 域名 系统 ) 
原生 代 币 

网 络 传播 算法 

市 场 网 络 

未 来 币 

N 算法 


English 中 文 


nested subchains 仍 套 子 链 
NFC (Near Field Communication ) 非 接触 式 
NIST5 NISTS 是 一 种 新 算法 ， 由 TalkCoin 首创 
nodes 节点 
nonce 随机 数 
noncurrency 非 货币 
nondeterministic wallets 非 确 定性 的 
O 
off-chain 链 下 
on full nodes 在 全 节点 上 
on new nodes 在 新 节点 上 
on SPV nodes 在 SPV 节点 上 
on the bitcoin network 在 比特 币 网 络 中 
one-hop network 单 跳 网 络 
OP RETURN operator OP RETURN 操作 符 
OpenSSL cryptographic library OpenSSL 密码 库 
open Source of bitcoin 比特 币 的 开源 性 
Open Transaction (OT) 开放 交易 
orphan block 孤儿 块 
Oracles 价值 中 介 
OWAS 单 向 聚合 签名 
OTC (Over the Counter) 场 外 交易 
outputs 输出 
及 
P2P Pool 一 种 点 对 点 方式 的 矿 池 
parent blocks 父 区 块 
parent blockchain 主 链 
paths for 路 径 
Pay to script hash (P2SH ) P2SH 代码 ; 脚本 散 列 支付 方式 
payment channel 支付 通道 
P2SH address P2SH 地 址 ; 脚本 散 列 支付 地 址 
Peer-to-Peer networks P2P 网 络 
physical bitcoin storage 比特 币 物理 存储 
PIN-verification 芯片 密码 
plot/chunks of data 完整 数据 块 
pool operator of mining pools 矿 池 运营 方 
post-trade 易 


六 


后 
post-trade processing 易 后 处 理 


English 
PoI: Proof of Importance 
Ppcoin 
Premine 


priority of transactions 

Primecoin 

PoS: Proof of Stake 

PoW : Proof of Work 

Proof-of-Work algorithm 

Proof-of-Work chain 

propagating transactions on 

protein folding algorithms 

public child key derivation 

public key derivation 

public keys 

public blockchain/permissionless blockchain 
private blockchain/permissioned blockchain 
pump and bump 

purpose level (multiaccount structure) 


Python ECDSA library 


random 

random wallets 
raw value 
reentrancy 
regtech 

replay attacks 
Replace By Fee (RBF) 
retargeting 
recursive call 
RIPEMD160 
Ripple 

risk balancing 
risk diversifying 
root of trust 


root seeds 


sandbox 


Satoshis 


中 文 
重要 性 证 明 ( NEM 提出 来 的 一 种 共识 算法 ) 
点 点 币 
预 挖 
交易 优先 级 
素数 币 
股权 证 明 
工作 量 证 明 
工作 量 证 明 算法 
工作 量 证 明 链 
交易 广播 
蛋白 质 折 释 算法 


六 
壮 
要 


~ 


瀛 | 六 
er 
Ht 


注 


全 
yr 
Het 


拉 升 出 货 
目标 层 (多 账户 结构 ) 
PythonECDSA 库 


随机 

随机 钱包 
原始 价格 

可 重 入 性 
监管 技术 
重 放 攻 击 
费用 替代 方案 
切换 目标 
递归 调用 
RIPEMD160,， 一 种 算法 
瑞 波 币 

适度 安保 
分 散 风险 
可 信和 根 

根 种 子 


沙 箱 


中 本 聪 


English 
scoops/4096 portions 
Scriptconstruction 
Script language 
Scripts 
Scrypt algorithm 
Scrypt-N algorithm 
Secure Hash Algorithm (SHA) 
security 
security thresholds 
seed nodes 
seeded 
seeded wallets 
selecting 
soft limit 
Segregated Witness (SW) 
SHA256 
SHA3 algorithm 
Shared Permission Blockchain 
shibes 
shopping carts public keys 


Simplified Payment Verification (SPV) nodes 
Simplified Payment Verification (SPV) wallet 


sidechain 

signature operations (sig ops) 
signature aggregation 

Skein algorithm 

smart pool 

smart contracts 

solo mining 

solo miners 

soft fork 

spilt 

Stellar 

stateless verification of transactions 
statelessness 

state machine replication 
storage 


Stratum (STM) mining protocol 


中 文 
子 数据 块 
脚本 构建 
脚本 语言 
脚本 
scrypt 算法 
scrypt-N 算法 
安全 散 列 算法 
安全 
安全 国 值 
种 子 节点 
种 子 
种 子 钱包 
软 限制 
隔离 见证 
SHA256 
SHA3 算法 
共享 认证 型 区 块 链 
狗 狗 币 粉丝 
购物 车 公 钥 
简易 支付 验证 (SPV ) 节点 
轻 钱 包 
侧 链 
处 理 签 名 操作 
签名 集合 
Skein 算法 
机 枪 池 《〈 即 智能 池 ) 
智能 合约 
单机 挖 矿 
独立 矿工 
软 分 义 
分 割 
恒星 币 
交易 状态 验证 
状态 机 原理 
存储 
Stratum 挖 矿 协 议 


English 
structure of 
SX tools 
Syncing the blockchain 
System Security 


Subchains 


taking offblockchain 

tainted address 

taint analysis 

TeleHash 

timeline 

timestamping blocks 

txids 

token 

token system 

token-less blockchain 

transaction fees 

transaction pools 

transaction processing 

transaction validation 

transactions independent verification 

transaction malleability 

tree structure 

Trezor wallet 

Turing Complete 

two-factor authentication 

tx messages 

Type-0 nondeterministic wallet 
U 

uncompressed keys 

unconfirmed transactions 

unspent outputs 

user security 

User Token 

UTXO pool 

UTXO set 

UTXOs 


中 文 
ee 的 结构 
sx 工具 
同步 区 块 链 
系统 安全 
子 链 


从 区 块 链 中 删除 
被 污染 的 地 址 
污点 分 析 

P2P 信息 发 送 系 统 
时 间 轴 

带 时 间 戳 的 区 块 
缩短 交易 标识 符 
代 币 

代 币 系统 

无 代 币 区 块 链 = 私 链 
交易 费 ; 矿工 费 
交易 池 

交易 处 理 

交易 验证 

独立 验证 交易 

树 结 构 

Trezor 钱包 

图 灵 完 备 

双 因 素 认 证 

tx 消息 


原始 随机 钱包 


解密 钥 

未 确认 交易 
未 花费 输出 
用 户 安全 性 
用 户 代 币 
UTXO 池 
UTXO 集合 
未 交易 输出 


English 


validating new blocks 


validation 


validation (transaction) 


vanity 

vanity addresses 
vanity-miners 
verification 
verification criteria 
version message 


visualise transaction 


W 


Wallet Import Format (WIF) 


wallets 

white hat attack 
weak blocks 
whitelist 


wildcard 


Xthin 
XRP (Ripple) 


zero knowledge proof 


zero codehash 


Zerocoin protocol 


附录 A ”区 块 链 相关 术语 


说 明 : 阅读 英文 文档 是 编程 开发 过 程 中 
内 容 。 该 帖子 仍 在 持续 更 新 中 ， 更 多 新 内 容 


最 常 
请 参 


中 文 
验证 新 区 块 
验证 条 件 
校 验 (交易 ) 
靓 号 
靓 号 地 址 
靓 号 挖掘 程序 
验证 
验证 条 件 
版 本 信息 
可 视 化 交易 


钱包 导入 格式 
钱包 
白 帽 攻击 
弱 区 块 
扬名 单 
通配符 


极 瘦 区 块 
瑞 波 币 


零 知识 证 明 
零 代码 散 列 
零 币 协议 


第 五 部 分 ”附录 


做 的 一 件 事 ， 英 文 阅 读 也 是 一 个 程序 员 的 基本 能 力 。 
照 下 面 的 地 址 阅读 原 帖 。 


原文 标题 : 《数字 货币 翻译 术语 (中 英 对 照 ) 》 


原文 地 址 : http://8btc.com/thread-17286-16-1.html 


本 文 已 经 征 得 原作 者 同意 ， 版 权 归 巴 比特 论坛 ， 在 此 感谢 社区 小 伙伴 们 的 参与 和 贡献 。 


区 块 链 刚 刚 起 步 ， 各 种 新 概念 层出不穷 ， 为 方便 大 家 学 习 和 使 


， 这 里 收录 了 巴 比 特 论坛 上 一 个 帖子 的 


English 
A 

account level (multiaccount structure) 
accounts 
adding blocks to 
addition operator 
addr message 
Advanced Encryption Standard (AES) 
aggregating 
aggregating into blocks 
alert messages 
altchains 


altcoins 


中 文 


账户 等 级 (多 账户 结构 ) 
账户 

增加 区 块 至 
加 法 操作 符 

地 址 消息 

高 级 加 密 标 准 (AES) 
聚合 

聚集 至 区 块 

警告 信息 

竞争 币 区 块 链 

竞争 币 


English 
AML 
anonymity focused 
antshares 
appcoins 
API 
App Coins 
architecture 
assembling 
attacks 
attack vectors 
Autonomous Decentralized Peer-to-Peer Telemetry 
auxiliary blockchain 


authentication path 


backing up 

balanced trees 

balances 

bandwidth 

Base58 Check encoding 
Base58 encoding 
Base-64 representation 
BFT (Byzantine Fault Tolerance) 
binary hash tree 
BIP0038 encryption 
bitcoin addresses vs. 
bitcoin core engine 
bitcoin ledger 

bitcoin network 
Bitcoin network deficit 
Bitcoin miners 

Bitcoin mixing services 
Bitcoin source code 
BitLicense 

BIP152 

Bitmain 

Bitmessage 

BITNET 


Bitshares 


中 文 
反 洗钱 
匿名 的 
小 蚁 
应 用 币 
应 用 程序 接口 
应 用 币 
架构 
集合 
攻击 
攻击 向 量 
去 中 心 化 的 P2P 自动 遥测 系统 
辅 链 
认证 路 径 


Base58 Check 编码 
Base58 编码 
Base-64 表示 
拜占庭 容错 
二 又 散 列 树 
BIP0038 加 密 标准 
比特 币 地 址 与 
比特 币 核心 引擎 或 网 络 
比特 币 账目 
比特 币 网 络 
比特 币 网 络 赤 字 
比特 币 矿工 

混 币 服务 
比特 币 源码 

数字 货币 许可 
比特 币 改进 提议 
比特 大 陆 

比特 信 

币 联网 

比特 股 


English 
BitTorrent 
Blake algorithm 
block chain apps 
block generation rate 
block hash 
block header hash 
block headers 
block height 
blockmeta 
block templates 
blockchains 
bloom filtersand 
BOINC open grid computing 
brain wallet 
broad casting to network 
broad casting transactions to 
bytes 


Byzantine fault-tolerant 


call 

CCVM (Cross Chain Virtual Machine) 
centralized control 

chaining transactions 


chainwork 


Check Block function (Bitcoin Coreclient) 


CHECKMULTISIG implementation 
Check SequenceVerify (CSV ) 
checksum 

child key derivation (CKD) function 
child private keys 

Child Pays For Parent，CPFP 
coinbase reward calculating 
coinbase rewards 

coinbase transaction 

cold-storage wallets 

compact block 

compact block relay 


colored coins 


中 文 
文件 分 享 
Blake 算法 
区 块 链 应 用 
出 块 速度 
区 块 散 列 值 
区 块头 散 列 值 
区 块头 
区 块 高 度 
区 块 元 
区 块 模板 
区 块 链 
布 鲁 姆 过 滤器 (bloom 过 滤器 ) 
BOINC 开放 式 网 格 计算 
脑 钱包 
全 网 广播 
广播 交易 到 
字 节 
拜占庭 容错 


调用 

跨 链 交易 的 虚拟 机 

中 心 化 控制 

交易 链条 

区 块 链 上 工作 量 总 

区 块 检查 功能 (BitcoinCore 客户 端 ) 
CHECKMULTISIG 实现 
检查 序列 验证 /CSV 


校 验 和 

子 密 钥 导 出 (CKD) 函数 
子 私 钥 

父子 支付 方案 

coinbase 奖励 计算 
coinbase 奖励 

coinbase 交易 

冷 钱包 

致密 区 块 
致密 区 块 中 继 


彩色 币 


English 
compressed keys 
compressed private keys 
compressed public keys 
computing power 
connections 
consensus 
consensus ledger 
consensus attacks 
consensus innovation 
consensus plugin 
confidential transactions 
constant 
constructing 
constructing block headers with 
converting compressed keys to 
converting to bitcoin addresses 
conversion fee 
consortium blockchains 
counterparty protocol 
counterparty 
creating full blockchains on 
creating on nodes 
crypto community 
crypto 2.0 ecosystem 
cryptocurrency 
Cunningham chains 


currency creation 


Darkcoin 


data structure 


DAO (Decentralized Autonomous Organization ) 


debt token 

decentralized 
decentralized consensus 
decentralised applications 


decentralised platform 


decoding BaseS58Check to/from hex 


decoding to hex 


中 文 
压缩 钥 
压缩 格式 私 钥 
压缩 格式 公 钥 
算 力 
连接 
共识 
共识 账本 
一 致 性 功能 攻击 
一 致 性 的 创新 
共识 算法 
保密 交易 


Ei 


党 
建造 

通过 …… 构 造 区 块头 部 
将 压缩 地 址 转换 为 
转换 为 比特 币 地 址 

部 换 费 用 
共同 体 区 块 链 
合约 方 协议 

合约 币 

建立 全 节点 于 

在 节点 上 新 建 

加 密 社区 

加 密 2.0 生态 系统 

加 密 货币 

坎 宁 安 链 

货币 创造 


暗黑 币 ( 译 者 注 : 现 已 更 名 为 达 世 币 Dash) 
数据 结构 

去 中 心 化 自治 组 织 

债权 代 币 

去 中 心 化 

去 中 心 化 共识 

去 中 心 化 应 用 

去 中 心 化 平台 
Base58Check 编码 与 十 六 进 制 的 相互 转换 
解码 为 十 六 进 制 


English 
deep web 
decode raw transaction 
deflationary money 
Delegated Proof of Stake (DPoS ) 
demurrage currency 
denial of service attack 
detached block 
deterministic wallets 
DEX: Distributed EXchange 
difficulty bits 
difficulty retargeting 
difficulty targets 
digital notary services 
digital currency 
distributed hash table 


Distributed Autonomous Corporations Runtime System 


(DACRS) 


Distributed Ledger Technology (DLT) 
Domain Name Service (DNS) 
double-spend attack 

double spend 

Dogecoin 


DoS (Denial of Service) attack 
DPoS 


dual-purpose 
dual-purpose mining 


dust rule 


eavesdroppers 

ecommerce servers keys for… 
ECDSA 

Eigentrust++ for nodes 

electricity cost 

electricity cost and target difficulty 
Electrum wallet 

ellipticcurve multiplication 


Emercoin (EMC) 


中 文 
深 网 
解码 原始 交易 
通缩 货币 
授权 股权 证 明 机 制 
清 期 费 
拒绝 服务 攻击 
分 离 块 
确定 性 钱包 
去 中 心 化 交易 所 
难度 位 
难度 调整 
难度 目标 
数字 公正 服务 
数字 货 
分 布 式 散 列 表 


自治 系统 运行 环境 


分 布 式 账簿 技术 

域名 服务 (DNS) 

双重 支付 攻击 

双 花 

狗 狗 币 

拒绝 服务 攻击 

授权 股权 证 明 机 制 DPoS 算法 
(在 PoS 基础 上 的 改良 ) 
双重 目标 

双重 目的 挖 矿 

尘 额 规则 (极其 小 的 余额 ) 


窃听 者 

电子 商务 服务 器 …… 的 密 钥 
椭圆 曲线 数字 签名 算法 保障 
用 于 节点 的 Eigentrust++ 技术 
电力 成 本 

电力 消耗 与 目标 难度 
Electrum 钱包 

椭圆 曲线 乘法 

崛起 币 


English 
encoding/decoding from BaseS8Check 
encrypted 
encrypted private keys 
Equity Token 
Ethereum 
External Owned Account (EOA) 
ether 
extended key 
extra nonce Solutions 


extraBalance 


Factom 

fault tolerance 

Feathercoin 

fees 

FRN 

FBRP 

Foward Error Correction (FEC) 
Field Programmable Gate Array (FPGA) 
financial disintermediation 
fintech 

fork attack 

forks 

fraud proofs 


full nodes 


generating 

generation transaction 

generator point 

genesis block 

GetBlock Template (GBT) mining protocol 

getting on SPV nodes 

GetWork (GWK ) mining protocol 

Graphical Processing Units (GPUs ) 

(Globally Unique Identifier，GUID ) 
H 

hackers 


halving 


( 续 ) 


中 文 
依据 Base58Check 编码 / 解码 
加 密 
加 密 私 钥 
权益 代 币 
以 太 坊 
外 有 账户 
以 太 币 
扩展 密 钥 
添加 额外 nonce 的 方式 
附加 余额 


公证 通 

外 加 容错 

羽毛 币 

手续 费 
快速 中 继 网 络 
快速 区 块 中 继 协 议 
向 前 纠 错 

现场 可 编程 门 阵列 (FPGA) 
金融 脱 媒 

金融 技术 
分 叉 攻击 

分 又 

欺诈 证 明 


生成 

区 块 创始 交易 

生成 点 

创始 区 块 

GetBlockTemplate (GBT) 挖 矿 协 议 
获取 SPV 节点 

GetWork (GWK) 控 矿 协议 

图 形 处 理 单 元 (GPUs ) 

全 域 唯一 识别 元 


黑客 
减 半 


English 
hardware wallets 
hard fork 
hard limit 
hash 
Hardware Security Modules (HSM) 
hashing powerand 
hashcash algorithm 
HD wallet system 
header hash 
heavyweight wallet 
Hierarchy Deterministic (HD) 
honesty 
hyperledger 


human readable format 


identifiers 

immutability of blockchai 
implementing in Python 
in block header 
independent verificatio 
innovation 

inputs 

Internet of Things 
instamine 

Invertible Bloom Lookup Table (IBLT) 
invalid numerical value 


InterPlanetary DataBase (IPDB) 


K 
key formats 
key-value 
Know Your Customer (KYC) 
Ls 


LevelDB database (Google) 
light weight 

linking blocks to… 

linking to blockchain 
Lightning Network (LN) 


linear scale 


中 文 
硬件 钱包 
人 硬 分 义 
人 硬 限制 
散 列 值 
硬件 安全 模块 
散 列 算 力 
散 列 现金 算法 
分 层 确 定性 钱包 系统 
头 部 散 列 值 
重量 级 钱包 
分 层 确 定 的 
诚信 算 力 
超级 账本 
人 类 可 读 模 式 


标识 符 

区 块 链 不 可 更 改 性 
由 Python 实现 

在 区 块 的 头 部 
独立 验证 

创新 

输入 

物 联网 

偷 控 

可 逆 式 布 鲁 姆 查找 表 
无 效 数 值 

星际 数据 库 


密 钥 格 式 
键 值 
了 解 你 的 客户 


LevelDB 数据 库 (Google) 
轻 量 级 

将 区 块 连接 至 … 

连接 至 区 块 链 

闪电 网 络 

线性 尺度 


English 
Litecoin 
lock time 
locking Scripts 
log scale 
M 
mainnet 


managed pools 

mastercoin protocol 
masternode 

memorypool (mempool) 
Merkle tree (Merkle Hash tree) 
Merkle root 

metachains 

mining 

mining blocks successfully 
mining pools 

mining rigs 

micropayment 

microblocks 

modifying private key formats 
monetary parameter alternatives 
Moore s Law 

Moonpledge 

MPC 

multi account structure 
multi-hop network 
multi-signature 
multi-signature addresse 
multi-signature scripts 


multi-signatureaccount 


Namecoin 

native token 

navigating 

Network Propagation 
Network of marketplaces 
Nextcoin (NXT) 
Neoscrypt 


( 续 ) 


中 文 
莱特 币 
锁定 时 间 
锁定 脚本 
对 数 单位 


主 网 

万 事 达 币 协议 
主 节点 

内 存 池 

二 进 制 的 散 列 树 或 二 又 散 列 树 ， 也 称 为 “ 默 克 尔 树 ” 
二 进 制 散 列 树 根 
附 生 块 链 

挖 矿 

成 功 产 ( 挖 ) 出 区 块 
矿 池 

矿 机 

小 额 支 付 

微 区 块 
修改 密 钥 格式 
货币 参数 替代 物 
摩尔 定律 

月 球 之 拆 

多 方 计 算 

多 重 账户 结构 
多 跳 网 络 

多 重 签名 

多 重 签名 地 址 
多 重 签名 脚本 
多 重 签名 账户 


域名 币 (基于 比特 币 技术 的 分 布 式 域名 系统 ) 
原生 代 币 

网 络 传播 算法 

市 场 网 络 

未 来 币 

N 算法 


English 中 文 


nested subchains 仍 套 子 链 
NFC (Near Field Communication ) 非 接触 式 
NIST5 NISTS 是 一 种 新 算法 ， 由 TalkCoin 首创 
nodes 节点 
nonce 随机 数 
noncurrency 非 货币 
nondeterministic wallets 非 确 定性 的 
O 
off-chain 链 下 
on full nodes 在 全 节点 上 
on new nodes 在 新 节点 上 
on SPV nodes 在 SPV 节点 上 
on the bitcoin network 在 比特 币 网 络 中 
one-hop network 单 跳 网 络 
OP RETURN operator OP RETURN 操作 符 
OpenSSL cryptographic library OpenSSL 密码 库 
open Source of bitcoin 比特 币 的 开源 性 
Open Transaction (OT) 开放 交易 
orphan block 孤儿 块 
Oracles 价值 中 介 
OWAS 单 向 聚合 签名 
OTC (Over the Counter) 场 外 交易 
outputs 输出 
及 
P2P Pool 一 种 点 对 点 方式 的 矿 池 
parent blocks 父 区 块 
parent blockchain 主 链 
paths for 路 径 
Pay to script hash (P2SH ) P2SH 代码 ; 脚本 散 列 支付 方式 
payment channel 支付 通道 
P2SH address P2SH 地 址 ; 脚本 散 列 支付 地 址 
Peer-to-Peer networks P2P 网 络 
physical bitcoin storage 比特 币 物理 存储 
PIN-verification 芯片 密码 
plot/chunks of data 完整 数据 块 
pool operator of mining pools 矿 池 运营 方 
post-trade 易 


六 


后 
post-trade processing 易 后 处 理 


English 
PoI: Proof of Importance 
Ppcoin 
Premine 


priority of transactions 

Primecoin 

PoS: Proof of Stake 

PoW : Proof of Work 

Proof-of-Work algorithm 

Proof-of-Work chain 

propagating transactions on 

protein folding algorithms 

public child key derivation 

public key derivation 

public keys 

public blockchain/permissionless blockchain 
private blockchain/permissioned blockchain 
pump and bump 

purpose level (multiaccount structure) 


Python ECDSA library 


random 

random wallets 
raw value 
reentrancy 
regtech 

replay attacks 
Replace By Fee (RBF) 
retargeting 
recursive call 
RIPEMD160 
Ripple 

risk balancing 
risk diversifying 
root of trust 


root seeds 


sandbox 


Satoshis 


中 文 
重要 性 证 明 ( NEM 提出 来 的 一 种 共识 算法 ) 
点 点 币 
预 挖 
交易 优先 级 
素数 币 
股权 证 明 
工作 量 证 明 
工作 量 证 明 算法 
工作 量 证 明 链 
交易 广播 
蛋白 质 折 释 算法 


六 
壮 
要 


~ 


瀛 | 六 
er 
Ht 


注 


全 
yr 
Het 


拉 升 出 货 
目标 层 (多 账户 结构 ) 
PythonECDSA 库 


随机 

随机 钱包 
原始 价格 

可 重 入 性 
监管 技术 
重 放 攻 击 
费用 替代 方案 
切换 目标 
递归 调用 
RIPEMD160,， 一 种 算法 
瑞 波 币 

适度 安保 
分 散 风险 
可 信和 根 

根 种 子 


沙 箱 


中 本 聪 


English 
scoops/4096 portions 
Scriptconstruction 
Script language 
Scripts 
Scrypt algorithm 
Scrypt-N algorithm 
Secure Hash Algorithm (SHA) 
security 
security thresholds 
seed nodes 
seeded 
seeded wallets 
selecting 
soft limit 
Segregated Witness (SW) 
SHA256 
SHA3 algorithm 
Shared Permission Blockchain 
shibes 
shopping carts public keys 


Simplified Payment Verification (SPV) nodes 
Simplified Payment Verification (SPV) wallet 


sidechain 

signature operations (sig ops) 
signature aggregation 

Skein algorithm 

smart pool 

smart contracts 

solo mining 

solo miners 

soft fork 

spilt 

Stellar 

stateless verification of transactions 
statelessness 

state machine replication 
storage 


Stratum (STM) mining protocol 


中 文 
子 数据 块 
脚本 构建 
脚本 语言 
脚本 
scrypt 算法 
scrypt-N 算法 
安全 散 列 算法 
安全 
安全 国 值 
种 子 节点 
种 子 
种 子 钱包 
软 限制 
隔离 见证 
SHA256 
SHA3 算法 
共享 认证 型 区 块 链 
狗 狗 币 粉丝 
购物 车 公 钥 
简易 支付 验证 (SPV ) 节点 
轻 钱 包 
侧 链 
处 理 签 名 操作 
签名 集合 
Skein 算法 
机 枪 池 《〈 即 智能 池 ) 
智能 合约 
单机 挖 矿 
独立 矿工 
软 分 义 
分 割 
恒星 币 
交易 状态 验证 
状态 机 原理 
存储 
Stratum 挖 矿 协 议 


English 
structure of 
SX tools 
Syncing the blockchain 
System Security 


Subchains 


taking offblockchain 

tainted address 

taint analysis 

TeleHash 

timeline 

timestamping blocks 

txids 

token 

token system 

token-less blockchain 

transaction fees 

transaction pools 

transaction processing 

transaction validation 

transactions independent verification 

transaction malleability 

tree structure 

Trezor wallet 

Turing Complete 

two-factor authentication 

tx messages 

Type-0 nondeterministic wallet 
U 

uncompressed keys 

unconfirmed transactions 

unspent outputs 

user security 

User Token 

UTXO pool 

UTXO set 

UTXOs 


中 文 
ee 的 结构 
sx 工具 
同步 区 块 链 
系统 安全 
子 链 


从 区 块 链 中 删除 
被 污染 的 地 址 
污点 分 析 

P2P 信息 发 送 系 统 
时 间 轴 

带 时 间 戳 的 区 块 
缩短 交易 标识 符 
代 币 

代 币 系统 

无 代 币 区 块 链 = 私 链 
交易 费 ; 矿工 费 
交易 池 

交易 处 理 

交易 验证 

独立 验证 交易 

树 结 构 

Trezor 钱包 

图 灵 完 备 

双 因 素 认 证 

tx 消息 


原始 随机 钱包 


解密 钥 

未 确认 交易 
未 花费 输出 
用 户 安全 性 
用 户 代 币 
UTXO 池 
UTXO 集合 
未 交易 输出 


English 
validating new blocks 
validation 
validation (transaction) 
vanity 
vanity addresses 
vanity-miners 
verification 
verification criteria 
version message 
visualise transaction 

W 
Wallet Import Format (WIF) 
wallets 
white hat attack 


weak blocks 


whitelist 
wildcard 
X 
Xthin 
XRP (Ripple) 
VA 


zero knowledge proof 
Zero codehash 


Zerocoin protocol 


附录 B ”区 块 链 相关 名 词 


中 文 
验证 新 区 块 
验证 条 件 
校 验 (交易 ) 
靓 号 
靓 号 地 址 
靓 号 挖掘 程序 
验证 
验证 条 件 
版 本 信息 
可 视 化 交易 


钱包 导入 格式 
钱包 
白 帽 攻击 

弱 区 块 
扬名 单 
通配符 


极 瘦 区 块 
瑞 波 币 


零 知识 证 明 
零 代 码 散 列 
零 币 协议 


新 技术 的 最 大 问题 是 新 概念 太 多 ， 例 如 区 块 、 确 认 、 挖 矿 、SPV 客 户 和 51% 攻 击 等 ， 这 通常 是 学 习 和 掌握 一 项 新 技术 的 过 程 中 所 必须 了 解 的 。 笔 者 在 社区 小 伙伴 “ 珍 


惜 ” “一 ”“Tailor” 和 “Mojie” 等 的 帮助 下 ， 通 过 网 络 进行 收集 ， 并 对 这 些 概念 进行 了 适当 的 删改 和 整理 ， 现 将 区 块 链 相 关 的 名 词汇 总 如 下 ， 以 供 大 家 在 学 习 乃 至 工作 中 参考 使 用 。 


1. 密 码 学 


计算 上 不 可 行 : 如 果 有 人 有 兴趣 想 完 成 一 个 处 理 ， 但 是 需要 用 到 的 时 间 不 切实 际 的 长 (如 几 十 亿 年 ) ， 那 么 这 个 处 理 就 被 称 为 是 计算 上 不 可 行 。 通 常 ，2 的 80 次 方 的 计算 步骤 被 认为 是 计算 上 不 可 行 的 


下 限 。 


散 列 : 一 个 散 列 函 数 (或 散 列 算法 ) 是 一 个 处 理 ， 依 靠 这 个 处 理 ， 一 个 文档 (比如 一 个 数据 块 或 文件 ) 被 加 工 成 看 起 来 完全 是 随机 的 小 片 数据 (通常 为 32 个 字 节 ) ， 其 中 没有 意义 的 数据 可 以 被 复原 为 


文档 ， 并 且 其 最 重要 的 性 能 是 散 列 一 个 特定 的 文档 的 结果 总 是 一 样 的 。 


此 外 ， 极 为 重要 的 一 点 是 ， 找 到 具有 相同 散 列 的 两 个 文件 在 计算 上 是 不 可 能 


9。 一 般 情况 下 ， 即 使 只 改变 了 文件 的 一 个 字母 ， 也 将 完全 打 乱 散 列 。 例 如 ， 


“Saturday” 的 SHA3 散 列 为 


c38bbc8e93c09f6ed3fe39b5135da91ad1a99d397ef16948606cdcbd14929f9d,， 而 “Caturday” 的 SHA3 散 列 为 b4013c0eed56d5a0b448b02ec1d10dd18c1b3832068fbbdc65b98fa9b14b6dbf。 散 


列 值 经 常 被 用 作 以 下 用 途 : 为 无 法 伪造 的 特定 文档 而 创建 的 全 局 商定 标识 符 。 


加 密 : 与 被 称 为 钥匙 (例如 c85ef7d79691fe79573b1a7064c19c1a9819ebdbd1faaab1a8ec92344438aaf4) 的 短 字符 串 的 数据 相 结合 ， 对 文档 (明文 ) 所 进行 的 处 理 。 加 密会 产生 一 个 输 t 


文 ) ， 这 个 密 文 可 以 被 其 他 掌握 这 个 钥匙 的 人 “解密 ” 回 原来 的 明文 ， 但 是 对 于 没有 掌握 钥匙 的 人 来 说 ， 解 密 是 费解 的 且 是 计算 上 不 可 行 的 。 


tH ( 密 


公 钥 加 密 : 一 种 特殊 的 加 密 ， 具 有 在 同一 时 间 生 成 两 个 密 钥 的 处 理 (通常 称 为 私 钥 和 公 钥 ) ， 使 得 利用 一 个 钥匙 对 文档 进行 加 密 后 ， 可 以 用 另外 一 个 钥匙 对 文档 进行 解密 。 一 般 地 ， 正 如 其 名 字 所 建议 


的 ,个 人 发 布 他 们 的 公 钥 ， 并 给 自己 保留 私 钥 。 


数字 签名 : 是 一 种 用 户 用 私 钥 为 文档 产生 一 段 短 字 符 串 数据 (这 段 字符 串 数据 称 为 签名 ) 的 算法 ， 以 至 于 任何 拥有 相应 公 钥 、 签 名 和 文档 的 


人 都 可 以 验证 : @ 该 文件 是 由 特定 的 私 钥 的 拥有 者 “ 签 


名 ”的 ; @ 该 文档 在 签名 后 没有 被 改变 过 。 数 字 签名 不 同 于 传统 的 签名 ， 在 传统 签名 上 可 以 在 签名 后 涂抹 多 余 的 文字 ， 而 且 这 样 做 无 法 被 分 辨 ， 在 数字 签名 后 对 文档 所 进行 的 任何 改变 都 会 使 签名 无 效 。 


2. 区 块 链 


地 址 : 一 个 地 址 本 质 上 是 


属于 特定 


散 列 值 ， 但 


交易 : 一 个 交易 是 一 个 脚本 程序 ， 授 权 与 区 块 链 相 关 的 一 些 特定 操作 。 在 一 种 加 密 货 


易 类 型 。 


为 了 简 和 


区 块 : 一 个 


区 块 链 ， 其 包含 了 一 个 网 络 呈 
通常 都 包括 了 每 个 账户 的 目前 状态 (比如 ， 货 站 


和 起见 ， 最 好 忽略 这 种 区 别 。 


的 全 部 交易 历史 。 注 意 : 有 些 基 于 


户 的 公 钥 的 表现 ， 例 如 ， 与 上 


面 给 出 的 私 钥 相 关联 的 地 址 是 cd2a3d9f938e13cd947ec05abc7fe734df8dd826。 注 意 : 在 实际 中 ， 地 址 从 技术 上 来 说 是 一 个 公 钥 的 


区 块 链 的 加 密 货币 里 会 使 


区 块 是 一 个 数据 包 ， 其 中 包含 零 个 或 多 个 交易 ， 前 块 (“ 父 块 ”) 的 散 列 值 ， 以 及 可 选 的 


余额、 


创 世 区 块 : 创 世 区 块 指 区 块 链 


上 的 第 一 个 区 块 ， 


账户 : 账户 是 在 总 账 中 的 记录 
被 存储 到 账户 内 。 


" 控 矿 ”: 


， 由 它 的 地 址 来 进行 索引 ， 总 账 包含 有 关 该 账户 状态 的 完整 数据 。 在 一 


来 初始 化 相应 的 加 密 货币 。 


履行 的 部 分 合约 、 注 册 等 ) 的 全 部 备份 ， 并 允许 


数量 的 币 ( 


区 块 中 交易 的 全 部 费 


“ 控 矿 ”是 反复 总 计 交 易 ， 构 建 


) 作为 奖励 。 而 且 所 有 的 “矿工 ”开始 尝试 创建 新 的 区 块 ， 


陈腐 区 


幽灵 ( 
安全 性 , 并 


披 块 : 


分 又 : 
度 不 同 ， 如 


硬 分 又 


软 分 叉 
上 进行 工作 


双重 花费 : 是 一 个 故意 而 为 之 的 分 又 ， 指 一 个 有 着 大 量 挖 矿 能 力 的 


块 : 对 于 同一 个 父 块 ， 


Ghost) : 幽灵 是 一 个 


已 经 有 另外 一 个 


区 块 ， 并 尝试 不 同 的 随机 数 ， 直 到 找到 一 个 


"总 账 " 这 个 记 


里， 主要 的 交易 类 型 是 向 别人 发 送 货币 单位 ; 在 其 他 系统 ， 如 亿 书 中 ， 实 名 认证 、 发 布 文章 等 操作 也 是 有 效 的 交 


其 他 数据 。 除 了 初始 的 “ 创 世 区 块 ”以 外 ， 每 个 区 块 都 包含 它 父 块 的 散 列 值 ， 区 块 的 全 部 集合 称 为 
语 来 代替 区 块 链 。 两 者 的 意思 大 致 是 相同 的 ， 虽 然 在 使 用 “总 账 ” 这 个 术语 的 系统 里 ， 每 个 区 块 


户 抛弃 过 时 的 历史 数据 。 


个 货币 系统 里 ， 它 包含 了 货币 余额 ， 或 许 还 有 未 完成 的 交易 订单 ， 在 其 他 情况 下 更 复杂 的 关系 可 以 


杂 机 数 可 以 符合 工作 证 明 的 条 件 的 过 程 。 如 果 一 个 “矿工 ”走运 并 产生 了 一 个 有 效 的 区 块 ， 那 么 他 会 被 授予 一 定 
这 个 新 区 块 包含 作为 父 块 的 最 新 的 区 块 的 散 列 。 


区 块 被 创建 出 来 ， 之 后 又 被 创建 的 区 块 。 


陈腐 区 块 通常 会 被 丢弃 ， 是 一 种 精力 的 浪费 。 


协议 ， 通 过 这 个 协议 ， 区 块 可 以 包含 不 只 是 它们 父 块 的 散 列 值 ， 也 会 散 列 父 块 的 父 块 的 其 他 子 块 (被 称 为 “ 叔 块 ”) 的 陈腐 区 块 。 这 确保 了 陈腐 区 块 仍然 有 助 于 区 块 链 的 


减轻 了 大 型 矿工 在 快速 


是 父 区 块 的 父 区 块 的 子 


区 块 链 上 具有 优势 的 问题 ， 


区 块 ， 但 不 是 自 个 的 父 


指向 同一 个 父 块 的 两 个 


果 其 中 一 个 链 上 的 “矿工 ”更 幸运 ， 他 们 所 在 的 那 条 链 增长 得 更 快 那么 所 有 的 


: 当 比 特 币 协议 规则 发 生 改 变 时 ， 旧 节点 拒绝 接受 由 新 节点 创造 


: 当 比 特 币 协议 规则 发 生 改 变 时 ， 旧 的 节点 并 不 会 意识 到 规 风 


因为 他 们 能 够 立即 得 知 自己 的 


区 块 ， 或 者 更 通俗 地 说 是 祖先 的 子 


区 块 ， 所 以 不 太 可 能 产生 陈腐 区 块 。 


区 块 ， 但 不 是 自己 的 祖先 。 如 果 A 是 B 的 一 个 上 朱 区 块 ， 那 么 B 就 是 A 的 侄 区 块 。 


区 块 被 同时 生成 的 情况 ， 某 些 部 分 的 “矿工 ”会 看 到 其 中 一 个 区 块 ， 其 他 的 “矿工 ” 则 看 到 另外 一 个 区 块 。 这 将 导致 两 条 区 块 链 同时 增长 。 通 常 来 说 ， 这 两 条 链 的 增长 速 


“矿工 ”都 会 转 到 那 条 链 上 。 据 统计 ， 最 长 会 在 4 个 区 块 内 决 出 胜 负 ， 自 动 解决 分 叉 。 


的 区 块 的 情况 。 违 反 规则 的 区 块 将 被 忽视 ，“ 矿 工 ” 会 按照 他 们 的 规则 集 ， 在 他 们 最 后 见证 的 区 块 之 后 创建 区 块 。 


是 不 同 的 ， 它 们 将 遵循 改变 


后 的 规则 集 ， 继 续 接受 由 新 节点 创造 的 区 块 。 “矿工 ” 们 可 能 会 在 他 们 完全 没有 理解 或 者 验证 过 的 区 块 


始 交易 的 区 


块 在 同一 个 


矿 ” 成 功 。 若 低 于 50%， 有 部 分 可 能 性 会 成 功 。 但 是 它 经 常 在 深度 2~5 上 有 唯一 显著 的 可 能 。 


认 ” ) 。 


3. 比 特 币 等 区 块 链 产 品 


BIP: 比特 币 改进 提议 ，Bitcoin Improvement Proposals 的 缩写 ， 指 比特 币 社 


比特 币 : 


确认 : 
且 难 以 逆转 


“比特 币 ” 既 可 以 指 这 种 虚拟 货币 单位 ， 也 可 以 指 比特 


当 一 项 交易 被 区 块 收录 时 ， 我 们 可 以 说 它 有 一 次 确认 。 


“矿工 ” 们 在 此 


6 网 络 或 网 络 节点 使 用 的 比特 币 软 件 。 


户 发 送 一 个 交易 来 购买 产品 ， 在 收 到 产品 后 又 做 出 另外 一 个 交易 把 相同 量 的 币 发 给 自己 。 攻 击 者 创造 一 个 区 块 ， 这 个 区 块 和 包含 原 
层次 上 ， 但 是 所 包含 的 并 非 原始 交易 而 是 第 二 个 交易 ， 并 且 开 始 在 这 个 分 又 上 “ 挖 矿 ”。 如 果 攻 击 者 有 超过 50% 的 “ 挖 矿 ”能 力 ， 双 重 花 费 最 终 可 以 保证 在 任何 区 块 深度 上 “ 挖 
此 在 大 多 数 的 加 密 货币 交易 所 还 有 金融 服务 在 接受 支付 之 前 需要 等 待 6 个 区 块 被 生产 出 来 (也 称 “6 次 确 


区 成 员 所 提交 的 一 系列 改进 比特 币 的 提议 。 例 如 ，BIP0021 是 一 项 改进 比特 币 统一 资源 标识 符 (URI) 计划 的 提议 。 


难度 : 整个 网 络 会 通过 调整 “难度 ”这 个 变量 来 控制 生成 工作 量 证 明 所 需要 的 计算 力 。 


难度 目标 : 使 整个 网 络 的 计算 力 大 致 每 10 分 钟 产 生 一 个 


难度 调 


矿工 费 


区 块 所 需 


整 : BTC 整 个 


: 交易 的 发 起 者 通常 会 


向 网 络 缴纳 一 笔 


散 列 : 二 进 制 数据 的 一 种 数字 指纹 。 


“矿工 ”: “矿工 ”是 指 通过 不 断 村 

网 络 : 比特 币 网 络 是 一 个 由 若干 个 节点 组 成 的 

奖励 : 

私 钥 : 用 来 解锁 对 应 (钱包 ) 地 址 的 一 串 字 符 

交易 : 简单 地 说 ， 交 易 是 指 把 比特 币 从 一 个 地 
由 “矿工 ”节点 收集 并 封包 至 区 块 中 ， 永 久保 存在 

钱包 


SPV 客 户 端 (或 轻 客户 端 ) : 一 个 只 下 载 一 小 部 分 
手机 和 笔记 本 电脑 之 类 的 低 功率 或 低 存储 硬件 的 


的 难度 数值 即 为 难度 目标 。 


络 每 产生 2106 个 区 块 后 会 根据 之 前 2106 个 区 块 的 算 力 进 行 难度 调整 。 


区 块 之 后 每 再 产生 一 个 区 块 ， 此 项 交易 的 确认 数 就 再 加 一 。 当 确认 数 达 到 6 及 6 以 上 时 ， 通 常 就 会 认为 这 笔 交 易 比较 安全 并 


“矿工 ” 费 ， 


重复 散 列 运 算 来 产生 工作 量 证 明 的 各 


于 广播 交易 信息 和 数据 


区 块 的 P2P 网 络 。 


每 一 个 新 区 块 中 都 有 一 定量 新 创造 的 比特 币 用 于 奖励 算出 工作 量 证 明 的 “矿工 ”。 现 阶段 每 一 


于 处 理 这 笔 交 易 。 大 多 数 的 交易 需要 0.5 毫 比特 币 的 矿工 费 。 


区 块 有 25 比 特 币 的 奖励 。 


， 例 如 ，5J76sF8L5jTtzE96r66Sf8cka9y44wdpJjMwCxR3tzLh3ibVPxh。 


区 块 链 的 某 处 。 


址 转移 到 另 一 个 地 址 。 更 准确 地 说 ， 一 笔 “ 交 易 ” 是 指 


: 钱包 是 指 保存 比特 币 地 址 和 私 钥 的 软件 ， 可 以 用 它 来 接受 、 发 送 和 存储 你 的 比特 币 。 


区 块 链 的 客户 端 ， 选 择 性 地 下 载 一 小 部 分 的 状态 数 和 
户 能 够 保持 几乎 相同 的 安全 保证 。 


横 入 式 侧 链 (pegged sidechains) 技术 : 它 将 实现 比特 币 和 


一 个 经 过 签名 运算 的 ， 表 达 价 值 转移 的 数据 结构 。 每 一 笔 “ 交 易 ” 都 会 经 过 比特 币 网 络 传输 ， 


在 进行 区 块 链 验 证 和 维护 时 ， 不 需要 花费 兆 字 节 的 带宽 或 干 兆 字 节 的 存储 空间 ， 使 拥有 像 智 能 


[其 他 数字 资产 在 多 个 区 块 链 间 的 转移 ， 这 就 意味 着 用 户 在 使 用 他 们 已 有 资产 的 情况 下 ， 可 以 访问 新 的 加 密 货币 系统 。 


工作 量 证 明 (Proof-of-Work，PoW) : 一 种 共识 机 制 ， 该 机 制 是 一 方 〈 通 常 称 为 证 明 人 ) 出 示 计 算 结果 ， 众 所 周知 ， 这 个 结果 很 难 被 计算 但 却 很 容易 验证 。 通 过 对 这 个 结果 进行 验证 ， 任 何人 都 能 够 
确认 证 明 人 执行 了 一 定量 的 计算 工作 量 来 产生 这 个 结果 。 


权益 证 明 (Proof of Stake，PoS) : 一 种 共识 机 制 ， 该 机 制 是 指 当 创 造 一 个 


股份 授权 证 明 机 制 (DPoS) : 一 种 共识 机 制 ， 该 机 制 使 得 每 一 个 持 有 


6 的 人 对 加 密 货 


区 块 时 ， 矿 工 需要 创建 一 个 “ 币 权 ” 交 易 ， 交 易 会 按 设 定 的 比例 把 一 些 币 发 送 给 “矿工 ”本 身 ， 类 似 于 利息 。 


6 系统 中 的 节点 


户 进行 投票 ， 获 得 票数 最 多 的 101 个 节点 作为 代表 ， 可 获得 进行 交易 打包 计算 的 权利 ， 并 获得 天 


应 的 奖励 。 


零 知 识 证 明 : 证 明 者 和 验证 者 之 间 进 行 的 交互 ， 证 明 者 能 够 在 不 向 验证 者 提供 任何 有 用 信息 的 情况 下 ， 使 验证 者 相信 某 个 论断 是 正确 的 。 


比特 币 的 可 蔡 换 性 (Fungibitlity) : 持 有 的 比特 币 不 管 之 前 曾 进行 过 哪些 交易 历史 ， 包 括 可 能 会 涉及 的 毒品 交易 等 ， 它 都 与 刚 挖 出 来 的 “ 原 币 ”一 样 ， 完 全 可 以 平等 替换 。 不 过 现在 已 经 有 交易 所 或 其 
他 服务 公司 追踪 用 户 账户 比特 币 的 来 源 ， 一 旦 涉及 犯罪 ， 他 们 会 拒绝 接受 。 


环 签名 : 因 签 名 中 参数 Ci (ij=1，2，…，n) 根据 一 定 的 规则 首尾 相 接 组 成 环 状 而 得 名 。 其 实 就 是 实际 的 签名 者 使 用 了 
完整 的 环 。 任 何 验 证 人 都 可 以 利用 环 成 员 的 公 钥 来 验证 一 个 环 签名 是 否 由 某 个 可 能 的 签名 人 所 生成 。 


他 可 能 签字 者 的 公 钼 产生 了 一 个 带 有 断口 的 环 ， 然 后 又 用 私 钥 将 断口 连 成 了 一 个 


隔离 见证 (Segregated Witness，SW) : 用 户 在 交易 时 ， 会 把 比特 币 传送 到 有 别 于 传统 的 地 址 。 当 要 使 用 这 些 比特 币 的 时 候 ， 其 签署 〈 即 见证 ) 并 不 会 被 记录 为 交易 ID 的 一 部 分 ， 而 是 另外 处 理 。 也 
就 是 说 ， 交 易 1D 完 全 是 由 交易 状态 ( 即 结余 的 进出 ) 来 决定 的 ， 不 会 受到 见证 部 分 的 影响 。 


闪电 网 络 (Lightning Network，LN) : 一 个 可 扩展 的 微 支付 通道 网 络 。 交 易 双 方 若 在 区 块 链 上 预先 设 有 支付 通道 ， 则 可 以 多 次 、 高 频 、 双 向 地 通过 轧 差 方式 实现 瞬间 确认 的 微 支付 ;双方 若 无 直 接 的 
点 对 点 支付 通道 ， 只 要 网 络 中 存在 一 条 连通 双方 的 、 由 多 个 支付 通道 构成 的 支付 路 径 ， 那 么 闪电 网 络 也 可 以 利用 这 条 支付 路 径 实现 资金 在 双方 之 间 的 可 靠 转移 。 


序列 化 : 将 一 个 数据 结构 转换 成 一 个 字 节 序列 的 过 程 。 以 太 坊 在 内 部 使 用 的 编码 格式 称 为 递归 长 度 前 缀 编码 (RLP) 。 


帕 特 里 夏 树 : 一 种 数据 结构 ， 它 会 存储 每 个 账户 的 状态 。 这 棵 树 的 建立 是 通过 从 每 个 节点 开始 ， 再 将 节点 分 成 多 达 16 个 组 ， 然 后 散 列 每 个 组 ， 再 对 散 列 结果 继续 散 列 ， 直 到 整 棵 树 有 一 个 最 后 的 “ 根 散 
列 ” 为 止 。 该 树 具 有 如 下 重要 的 特性 : @ 只 有 一 个 可 能 的 树 ， 因 此 ， 每 个 数据 集 对 应 一 个 可 能 的 根 散 列 ，@ 很 容易 就 能 更 新 、 添 加 或 删除 树 节点 ， 以 及 生成 新 的 根 散 列 ，@ 若 不 改变 根 散 列 ， 则 没有 办 法 修 
改 树 的 任何 部 分 。 所 以 ， 如 果 根 散 列 被 包括 在 签名 的 文档 或 有 效 区 块 中 ， 签 名 或 工作 证 明 可 以 担保 整个 树 ;@ 任 何人 均 只 能 提供 一 个 下 到 特定 节点 的 分 支 ， 可 以 加 密 以 证 明 拥有 确切 内 容 的 节点 的 确 是 在 树 
里 。 帕 特 里 夏 树 也 被 用 来 存储 账户 ， 以 及 区 块 中 的 交易 。 


EVM 代 码 : 以 太 坊 虚拟 机 代码 ， 以 太 坊 的 区 块 链 可 以 包含 的 编程 语言 的 代码 。 消 息 每 次 被 发 到 账户 的 时 候 ， 就 执行 与 该 账户 相关 联 的 EVM 代 码 ， 并 且 其 具有 读 / 写 存储 和 自身 发 送 消息 的 能 力 。 


消息 : 一 种 由 EVM 代 码 从 一 个 账户 发 送 到 另 一 个 账户 的 “虚拟 交易 ”。 需 要 注意 的 是 ，“ 交 易 ” 和 “消息 ”在 以 太 坊 中 是 不 同 的 ; 以 太 坊 用 语 环 境 中 所 说 的 “交易 ”具体 指 的 是 物理 的 数字 签名 的 一 串 
数据 ， 并 且 每 个 交易 都 会 触发 相关 联 的 消息 ， 但 消息 也 可 以 通过 EVM 代 码 进行 发 送 ， 在 这 种 情况 下 ， 它 们 从 不 会 被 表示 成 任何 数据 。 


合约 : 一 个 包含 并 且 受 EVM 代 码 控制 的 账户 。 合 约 不 能 通过 私 铀 直接 进行 控制 ， 除 非 被 编译 成 EVM 代 码 ， 一 旦 合约 被 发 行 ， 就 没有 所 有 者 。 


4 .延伸 概念 


分 散 化 应 用 程序 : 为 了 某 些 特定 的 目的 〈 比 如， 在 某 些 市 场 上 连接 买 家 和 卖家 、 共 享 文件 、 网 络 文件 存储 、 维 持 货 币 等 ) ， 无 论 是 使 用 还 是 创建 一 个 分 散 的 网 络 ， 都 将 由 许多 人 来 运行 的 程序 。 一 个 这 
样 的 应 用 程序 通常 在 区 块 链 上 有 特定 的 相关 合约 ， 有 利于 创造 许多 合约 的 Dapps 是 完全 可 能 的 。 


分 散 化 组 织 : 一 个 没有 中 央 领 导 的 组 织 ， 其 使 用 正式 民主 投票 进程 和 共识 主动 性 自我 组 织 的 结合 来 作为 基本 的 操作 原则 。 它 不 太 会 令 人 印象 深刻 ， 但 有 时 会 与 “地 理 上 的 分 散 化 组 织 ” 相 混淆 ， 组 织 里 
的 人 分 布 在 相距 甚 远 的 地 方 工作 ， 甚 至 可 能 都 没有 办 公 室 ， 不 过 它们 可 能 会 有 中 央 领 导 。 


不 修 斯 标准 : 用 于 查 明 一 个 组 织 的 分 散 化 程度 的 测试 。 测 试 如 下 : 假设 组 织 里 有 N 个 人 ， 然 后 外 星人 每 次 从 组 织 中 (比如 每 周一 次 ) 挑选 出 K 个 人 来 ， 摧 有 毁 他 们 的 存在 ， 然 后 再 向 组 织 中 补充 K 个 对 组 织 
不 了 解 的 新 人 。 现 在 为 了 让 组 织 起 作用 ，K 可 以 高 达 多 少 个 人 呢 ? 在 独裁 政权 里 ， 当 K = 1 即 独裁 者 被 摧毁 后 就 会 失败 。 美 国政 府 稍微 好 一 点 ， 但 如 果 参 议院 和 国会 的 所 有 638 名 成 员 突然 消失 了 ， 仍 然 会 有 很 
大 的 问题 。 但 像 比特 币 或 BitTorrent， 即 便 是 对 极 高 的 K 值 也 具有 复原 性 ， 因 为 新 的 代理 人 可 以 简单 地 根据 自己 的 经 济 动机 来 填补 缺失 的 角色 。 还 有 一 个 更 严格 的 测试 ， 拜 占 庭 忒 修 斯 标准 ， 它 包含 同一 时 间 
内 随机 地 用 恶意 行为 者 取代 K 个 用 户 一 段 时 间 ， 之 后 再 替换 成 新 用 户 。 


代 币 制度 : 本 质 上 是 可 以 用 于 交易 的 虚拟 代 蔡 物 。 更 正式 地 说 ， 代 币制 度 是 一 个 数据 库 ， 它 将 地 址 映射 到 数字 ， 并 具有 以 下 属性 ， 基 本 允许 的 操作 是 把 N 个 代 币 从 A 转 给 B， 条 件 是 N 是 非 负 的 ， 且 N 不 
小 于 A 的 当前 余额 ， 授 权 该 转账 的 证 件 由 A 进 行 数字 签名 。 二 次 “发 行 ”和 “消费 ”的 操作 也 可 以 存在 ， 交 易 费 用 也 可 以 被 收集 ， 许 多 当事人 同时 进行 转账 也 是 可 能 的 。 典 型 应 用 案例 包括 货币 、 网 络 加 密 代 
币 ， 公 司 的 股份 和 数字 礼品 卡 等 。 


身份 : 一 组 可 以 加 密 验 证 的 互动 ， 具 有 同一 个 人 创建 的 的 属性 。 


唯一 的 身份 : 一 组 可 以 加 密 验 证 的 互动 ， 具 有 的 属性 包括 同一 个 人 创建 的 和 一 个 人 不 能 有 多 个 唯一 身份 的 约束 。 


激励 相 容 : 如 果 每 个 人 都 能 更 好 地 “遵守 规则 ”而 不 是 试图 欺骗 ， 除 非 至 少 要 有 大 量 的 人 都 同意 同时 一 起 欺骗 才 行 ， 那 么 协议 是 激励 相 容 的 。 


基本 收入 : 每 隔 一 段 时 间 (比如 几 个 月 ) 就 给 每 一 个 唯一 的 身份 发 送 一 定量 的 代 币 的 想法 。 其 最 终 目的 是 为 了 让 不 愿意 工作 或 不 能 工作 的 人 能 够 依靠 这 份 收入 活 下 来 。 这 些 代 币 可 以 简单 地 赁 空 制作 出 
来 ， 或 者 来 自 收 益 流 (比如 来 自 创 收 实体 或 政府 ) 。 为 了 单 靠 基 本 收入 就 使 人 能 够 生活 ， 可 能 会 用 到 多 个 收益 流 的 组 合 。 


声誉 : 身份 的 一 个 属性 。 其 他 实体 认为 这 个 身份 可 以 : 胜任 一 些 特定 的 任务 ， 且 在 一 些 情况 下 是 值得 信赖 的 。 比 如 ， 不 太 可 能 因为 短期 的 获 利 而 出 卖 别 人 。 


信任 网 络 : 举 个 例子 来 说 ， 如 果 人 A 高度 信任 B，B 高 度 信任 C， 则 A 可 能 是 信任 C 的 。 为 决定 特定 个 体 在 特定 概念 下 的 可 靠 性 的 复杂 而 有 力 的 机 制 ， 理 论 上 可 以 由 这 个 原则 推断 出 来 。 


第 三 方 托管 : 如 果 两 个 低 信誉 的 实体 从 事 某 项 贸易 时 ， 付 款 人 可 能 希望 把 钱 留 在 具有 高 信誉 的 第 三 方 ， 并 指示 只 有 在 产品 交付 之 后 ， 才 让 第 三 方 把 钱 发 给 收 款 人 。 这 就 减少 了 付款 人 或 收 款 人 欺诈 的 风 


保证 金 : 放 入 合约 里 的 涉及 另外 一 方 的 数字 资产 ， 如 果 某 些 条 件 不 满足 时 ， 该 资产 会 自动 被 对 方 没收 。 


抵押 : 放 入 合约 里 的 涉及 另外 一 方 的 数字 资产 ， 如 果 某 些 条 件 不 满足 时 ， 该 资产 会 自动 被 销毁 ， 或 者 据 献 给 慈善 ， 或 者 作为 基本 收入 基金 。 也 许 还 可 以 让 利益 广泛 分 配 ， 但 必须 保证 不 能 让 特定 的 个 人 


显著 受益 。 


5. 参 考 


维基 百科 : http://en.wikipedia.org/wiki/Public-key_cryptography 


《精通 比特 币 》: https://github.com/imfly/bitcoinbook 


附录 C ”关于 区 块 链 俱 乐 部 


区 块 链 俱乐部 ， 英 文 名 为 ChainClup， 简 称 CC， 目 标 是 围 


流 平台 。 


官方 网 站 地 址 为 : http://chainclub.org。 


运作 模式 


绕 区 块 链 进行 研发 、 运 营 与 投资 ， 并 不 断 发 现 、 培 养 和 聚合 


区 块 链 从 业 人 才 ， 打 造 


图 


内 最 具 影 响 力 的 区 块 链 管理 者 、 开 发 者 、 运 营 者 分 享 与 交 


ChainClub 实 行 会 员 免费 申请 、 邀 请 推荐 、 实 名 认证 的 加 入 机 制 。 通 过 定期 组 织 区 块 链 茶座 等 线 下 活动 ， 通 过 官网 、 公 众 号 等 媒介 ， 提 供 业 内 资讯 、 技 术 分 享 、 创 业 故 事 等 信息 ， 为 会 员 打造 一 套 成 熟 


的 集 线 上 线 下 讨论 和 分 享 于 一 体 的 社交 平台 。 


会 员 构成 


ChainClub 成 员 遍 布 全 世界 ， 如 果 你 是 从 事 区 块 链 开发 、 研 究 和 教育 等 行业 的 各 类 人 才 ， 包 括 但 不 限 了 


“ IT 公司 和 各 行业 企业 研发 部 门 的 CTO、 技 术 副 总 裁 、 首 席 架构 师 


、 技 术 总 监 、 项 目 总 监 、 


. 行政 管理 部 门 CEO、CFO、 法 律 顾问 、 营 销 总 监 等 运营 管理 人 员 。 


“ 各 大 院 校 、 研 究 院 所 的 高 级 教师 、 研 究 员 、 学 生 等 。 


会 员 权益 


在 这 里 ， 你 可 以 获得 如 下 会 员 权益 。 


交流 分 享 : 分 享 区 块 链 研究 心得 ， 探 讨 开发 经 验 、 管 理 实践 等 。 


拓展 人 脉 : 结识 更 多 区 块 链 业 界 领袖 ， 与 内 行 专家 零 距离 交流 ， 拓 


树立 品牌 : 增加 公司 曝光 度 ， 打 造 企业 技术 品牌 ， 提 升 个 人 影响 力 。 


学 习 成 长 : 洞悉 区 块 链 行业 的 产品 和 技术 变革 ， 掌 握 最 新 技术 和 发 


展 人 脉 关系 。 


展 趋势 。 


职业 生涯 : 企业 可 以 快速 找到 合适 的 人 才 ， 人 才 有 更 多 方便 直接 的 择业 机 会 。 


亿 书 服务 : 免费 获得 亿 书 开源 社区 的 有 关 技 术 、 培 训 和 咨询 服务 ， 获 得 亿 书 基金 的 技术 彤 化 机 会 ， 助 你 成 就 一 番 事 


加 入 条 件 
* 身心 健康 ， 文 明 礼 狐 ， 对 新 事物 、 新 技术 、 新 观点 有 好 坷 心 ， 兽 
* 草 重 亿 书 开源 理念 和 免费 分 享 的 价值 观 ， 愿 意 为 开源 社区 贡献 自 


“ 热爱 区 块 链 事业 ， 具 备 区 块 链 研 发 、 运 营 、 投 资 等 菜 一 方面 的 从 


重 不 同 的 观点 和 思想 。 


己 的 智慧 和 力量 。 


业经 验 者 优先 。 


产品 总 监 、 运 维 总 监 等 技术 管理 者 。 


E 


: 懂 软 硬件 开发 技术 者 优先 ， 熟 悉 C、C++、Java、JavaSctipt、Ruby、Python、Go 等 一 种 或 几 种 开发 语言 更 住 。 


“ 懂 互 联网 、 软 件 产品 运营 管理 者 优先 ， 有 大 公司 运营 管理 经 验 更 
: 有 写作 经 验 者 优先 ， 有 一 门 或 多 门 外 语 能 力 更 佳 。 


“ 积极 向 亿 书 反馈 亿 书 社区 和 各 类 产品 的 使 用 体验 ， 帮 助 开源 社区 


加 入 步骤 


严格 采取 实名 制 ! 我 们 会 严格 保护 会 员 的 隐私 ， 绝 不 会 将 会 员 信息 


佳 。 


发 展 。 


用 于 俱乐部 各 类 活动 之 外 的 其 他 用 途 。 


下 述 之 一 的 ， 都 可 以 加 入 我 们 。 


1) 请 提供 你 的 真实 姓名 + 公司 + 职务 ， 擅 长 的 领域 ， 常 用 的 联系 方式 (电话 、QQ、 微 信 、skype 等 ) ， 如 果 是 技术 人 员 ， 还 应 包括 Github 等 代码 托管 网 站 账号 等 ， 将 这 些 信息 发 送 邮件 到 


support@chainclub.org， 以 方便 活动 联系 。 


2) 关注 中 国 区 块 链 俱 乐 部 官方 网 站 ， 了 解 往 期 活动 内 容 和 最 新 活动 状态 。 


3) 关注 区 块 链 俱乐部 公众 号 (chainclub) ， 接 受 最 新 消息 推送 。 


联系 方式 


俱乐部 : http://chainclub.org 


ua 


方 邮箱 : support@chainclub.org 


亿 书 QQ 交 流 群 : 185046161 


亿 书 官网 : http://ebookchain.org 


后 记 


us 


“无 论 多 么 伟大 的 事情 ， 


后 往往 都 是 人 人 都 能 明白 的 简单 方法 。” 


这 是 我 最 近 在 转发 一 


朋友 圈 文 章 的 时 候 写 下 来 的 。 这 篇 文 


介绍 的 是 加 拿 大 的 一 位 入 


F 轻 人 ， 斯 科 特 : 杨 (Scott Young) ， 讲 述 他 


如 何 高 效 学 习 的 事情 。 斯 科 特 杨 通常 只 需要 花费 比 别 人 少 很 多 的 时 间 ， 却 能 获得 很 好 的 学 习 成 绩 。 他 的 法 宝 其 实 非 常 简单 ， 确 定 目标 之 后 ， 遵 循 “ 学 习 一 一 反馈 一 一 改进 ”这 样 的 方法 ， 直 到 目标 达成 。 实 
示 上 ， 不 管 你 是 否 相 和信， 任何 事情 只 要 成 功 了 ， 都 是 有 意 或 无 意 地 践 行 了 这 一 方法 。 在 编程 开发 领域 ， 用 一 个 比较 流行 的 词 来 形容 这 一 方法 ， 就 叫 “ 增 量 开发 ”， 表 简单 一 点 就 是 “迭代 ”。 


这 个 世界 上 没有 一 下 子 就 能 做 好 、 做 成 的 事情 ，“ 每 一 件 与 众 不 同 的 绝世 好 东西 ， 其 实 都 是 以 无 比 寂寞 的 勤奋 为 前 提 的 ， 要 么 是 血 要 么 是 汗 ， 要 么 是 大 把 大 把 的 曼妙 青春 好 时 光 ”， 这 些 付出 就 是 用 在 
反复 的 打磨 、 改 进 和 人 迭代 之 中 的 。 而 现实 往往 是 ， 历 经 了 这 样 的 磨 磊 ， 产 品 不 好 都 难 ， 或 者 说 不 惊世骇俗 就 是 低估 了 它 ， 根 本 不 需要 去 关心 经 过 这 样 的 学 习 之 后 ， 能 不 能 找到 工作 ， 更 不 用 担心 经 历 了 这 
些 ， 做 出 来 的 产品 有 没有 人 认可 。 相 反 ， 仪 仅 为 了 工作 ， 为 了 别人 的 眼光 ， 反 而 没有 了 坚持 做 下 去 的 动力 ， 最 终 的 结果 往往 是 跨 跑 光阴 ， 浪 费 生命 。 


我 无 意 间 又 一 次 践 行 了 这 样 的 做 法 。 最 初 撰写 和 分 享 本 书 中 的 这 些 文章 时 ， 目 的 非常 单纯 ， 只 是 想 通 过 代码 了 解 一 下 区 块 链 背 后 的 秘密 ， 并 没有 想 过 要 教 别 人 什么 ， 当 然 更 没有 想到 会 结集 出 版 。 所 
以 ， 本 书 是 在 完全 开源 开放 的 条 件 下 完成 的 ， 每 一 章 就 像 编程 一 样 通过 代码 库 管理 并 提交 到 Github 上 ， 定 稿 之 后 再 发 布 到 相关 论坛 和 社区 ， 基 本 上 每 周一 篇 。 写 作 时 ， 我 会 反复 修改 ;发 布 到 论坛 之 后 , 我 
会 根据 反馈 再 修改 ; 写 到 后 面 的 章节 时 ， 如 果 感觉 前 面 的 章节 有 | 问题 ， 还 会 返回 修改 。 本 书 版 本 库 的 提交 记录 接近 260 次 (这 是 完整 可 见 的 修改 次 数 ) 。 


尽管 如 此 ， 本 书 依然 不 够 完美 ， 毕 竟 短 短 的 几 个 月 时 间 ， 我 无 法 尽数 区 块 链 的 奇妙 和 全 部 细节 。 书 中 不 可 避免 地 会 存在 这 样 或 那样 的 问题 ， 至 少 在 内 容 上 ， 就 存在 一 个 重大 的 缺陷 ， 比 如 : 区 块 链 发 展 
到 现在 ， 单 一 主 链 已 经 显现 出 明显 的 劣势 ， 侧 链 注定 是 它 的 未 来 ， 但 是 本 书 没有 涉及 这 方面 的 内 容 。 不 是 不 想 ， 而 是 就 区 块 链 目前 的 现状 和 我 本 人 的 能 力 ， 还 不 足以 把 这 个 问题 描述 清楚 ， 需 要 讨论 和 研究 
的 问题 太 多 了 。 关 于 这 个 问题 ， 我 会 坚持 研究 下 去 ， 并 把 它 体现 在 亿 书 产品 里 ， 大 家 可 以 浏览 亿 书 源码 ， 探 究 它 的 实现 。 待 代码 成 熟 ， 我 会 继续 分 享 ， 补 全 这 部 分 内 容 。 


在 历经 8 个 多 月 以 及 很 多 个 挑灯 夜战 的 辛苦 之 后 ， 原 本 怀疑 是 否 会 中 途 放弃 的 写作 分 享 终于 暂时 告 一 段落 ， 内 心 多 少 还 是 有 点 澎 洲 的 。 澎 涯 的 不 是 终于 完整 分 享 了 全 部 内 容 ， 而 是 志 起 于 这 些 内 容 能 否 给 
读者 带 来 些许 帮助 ， 能 否 为 国内 的 区 块 链 发 展 做 出 点 什么 。 无 论 好 与 坏 ， 它 就 在 这 里 。 另 外 ， 本 书 虽 已 完结 ， 但 分 享 仍 将 继续 ， 因 为 区 块 链 的 发 展 才刚 刚 开始 。 


是 为 后 记 。 


2016 年 10 月 10 日 


